Update marketplace listing

curl --request PUT \
  --url https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-INVIEW-AUTH: <api-key>' \
  --data '
{
  "pharmacyNPI": 1234567890,
  "expirationDate": "12-31-2026",
  "fullPackage": true,
  "lotNumber": "1234ABC",
  "sealedPackage": true,
  "originalPackage": true,
  "tornPackageLabel": true,
  "serialNumber": "1234ABC",
  "additionalPackageNotes": "overstocked, selling this med.",
  "price": 125.5,
  "quantity": 30,
  "showOnlyInState": false
}
'

const options = {
  method: 'PUT',
  headers: {'X-INVIEW-AUTH': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pharmacyNPI: 1234567890,
    expirationDate: '12-31-2026',
    fullPackage: true,
    lotNumber: '1234ABC',
    sealedPackage: true,
    originalPackage: true,
    tornPackageLabel: true,
    serialNumber: '1234ABC',
    additionalPackageNotes: 'overstocked, selling this med.',
    price: 125.5,
    quantity: 30,
    showOnlyInState: false
  })
};

fetch('https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id}"

payload = {
    "pharmacyNPI": 1234567890,
    "expirationDate": "12-31-2026",
    "fullPackage": True,
    "lotNumber": "1234ABC",
    "sealedPackage": True,
    "originalPackage": True,
    "tornPackageLabel": True,
    "serialNumber": "1234ABC",
    "additionalPackageNotes": "overstocked, selling this med.",
    "price": 125.5,
    "quantity": 30,
    "showOnlyInState": False
}
headers = {
    "X-INVIEW-AUTH": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "buyerPharmacyName": "<string>",
  "buyerPharmacyNationalProviderIdentifier": 123,
  "buyersMessage": "<string>",
  "buyingPharmacyAddress": {
    "city": "<string>",
    "line1": "<string>",
    "line2": "<string>",
    "postalCode": "<string>",
    "stateAcronym": "<string>"
  },
  "buyingPharmacyName": "<string>",
  "buyingPharmacyDBA": "<string>",
  "buyingPharmacyPhone": 123,
  "cancellationDescription": "<string>",
  "cancelledDate": "2023-11-07T05:31:56Z",
  "drugPackageForm": "<string>",
  "drugPackageStrength": "<string>",
  "expirationDate": "2023-11-07T05:31:56Z",
  "fullPackage": true,
  "originalPackage": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "inventoryQuantity": 123,
  "labelerName": "<string>",
  "listingDate": "2023-11-07T05:31:56Z",
  "lotNumber": "<string>",
  "nationalDrugCode": "<string>",
  "nationalDrugCodeNormalized": "<string>",
  "additionalPackageNotes": "<string>",
  "packageName": "<string>",
  "paymentConfirmedDate": "2023-11-07T05:31:56Z",
  "price": 123,
  "pricePerQuantity": 123,
  "quantity": 123,
  "quantityUnitQualifier": "<string>",
  "sealedPackage": true,
  "sellerPharmacyName": "<string>",
  "sellerPharmacyDBA": "<string>",
  "sellerPharmacyNationalProviderIdentifier": 123,
  "sellerPharmacyPhone": 123,
  "sellerPharmacyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "shippingConfirmDate": "2023-11-07T05:31:56Z",
  "shippingReceivedConfirmDate": "2023-11-07T05:31:56Z",
  "soldDate": "2023-11-07T05:31:56Z",
  "tornPackageLabel": true,
  "sellerPharmacyAddress": {
    "city": "<string>",
    "line1": "<string>",
    "line2": "<string>",
    "postalCode": "<string>",
    "stateAcronym": "<string>"
  },
  "shipByDate": "2023-11-07T05:31:56Z",
  "branded": true,
  "generic": true,
  "gtin": "<string>",
  "serialNumber": "<string>",
  "referralGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "stateGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resultingMarketplaceListingRequestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

Marketplace Listings

Update marketplace listing

Updates an existing marketplace listing on InStockRx. Validates the pharmacy based on the provided NPI and token claims, then applies updates only if the listing is still in a Pending state.

Validation Rules

Field	Required	Type	Rules
PharmacyNPI	Yes	`long`	Must be a valid NPI
ExpirationDate	Yes	`string`	Must be a valid future date in ISO 8601 format (e.g. “2025-12-31T00:00:00Z”)
LotNumber	Yes	`string`	Non-empty string
Price	Yes	`decimal`	Must be a positive number
FullPackage	Yes	`bool`	Affects Quantity validation
Quantity	Yes	`decimal`	Must be positive. If FullPackage=true: must equal 1. If FullPackage=false: between 0.01 and the drug’s package size
SealedPackage	Yes	`bool`	-
OriginalPackage	Yes	`bool`	-
TornPackageLabel	No	`bool`	-
SerialNumber	No	`string`	If provided, must be a non-empty, non-whitespace string
AdditionalPackageNotes	No	`string`	If provided, must be a non-empty, non-whitespace string
ShowOnlyInState	No	`bool`	Not returned in the response. Instead, `stateGroupId` is returned: if `showOnlyInState = true`, `stateGroupId` will have a GUID value; if `false`, `stateGroupId` will be `null`

Note: Listing must be in Pending status to be updated. Returns 409 Conflict otherwise.

PUT

api

marketplace-listings

{id}

Update marketplace listing

curl --request PUT \
  --url https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-INVIEW-AUTH: <api-key>' \
  --data '
{
  "pharmacyNPI": 1234567890,
  "expirationDate": "12-31-2026",
  "fullPackage": true,
  "lotNumber": "1234ABC",
  "sealedPackage": true,
  "originalPackage": true,
  "tornPackageLabel": true,
  "serialNumber": "1234ABC",
  "additionalPackageNotes": "overstocked, selling this med.",
  "price": 125.5,
  "quantity": 30,
  "showOnlyInState": false
}
'

const options = {
  method: 'PUT',
  headers: {'X-INVIEW-AUTH': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pharmacyNPI: 1234567890,
    expirationDate: '12-31-2026',
    fullPackage: true,
    lotNumber: '1234ABC',
    sealedPackage: true,
    originalPackage: true,
    tornPackageLabel: true,
    serialNumber: '1234ABC',
    additionalPackageNotes: 'overstocked, selling this med.',
    price: 125.5,
    quantity: 30,
    showOnlyInState: false
  })
};

fetch('https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://test-instockrx-api.azurewebsites.net/api/v1/marketplace-listings/{id}"

payload = {
    "pharmacyNPI": 1234567890,
    "expirationDate": "12-31-2026",
    "fullPackage": True,
    "lotNumber": "1234ABC",
    "sealedPackage": True,
    "originalPackage": True,
    "tornPackageLabel": True,
    "serialNumber": "1234ABC",
    "additionalPackageNotes": "overstocked, selling this med.",
    "price": 125.5,
    "quantity": 30,
    "showOnlyInState": False
}
headers = {
    "X-INVIEW-AUTH": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "buyerPharmacyName": "<string>",
  "buyerPharmacyNationalProviderIdentifier": 123,
  "buyersMessage": "<string>",
  "buyingPharmacyAddress": {
    "city": "<string>",
    "line1": "<string>",
    "line2": "<string>",
    "postalCode": "<string>",
    "stateAcronym": "<string>"
  },
  "buyingPharmacyName": "<string>",
  "buyingPharmacyDBA": "<string>",
  "buyingPharmacyPhone": 123,
  "cancellationDescription": "<string>",
  "cancelledDate": "2023-11-07T05:31:56Z",
  "drugPackageForm": "<string>",
  "drugPackageStrength": "<string>",
  "expirationDate": "2023-11-07T05:31:56Z",
  "fullPackage": true,
  "originalPackage": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "inventoryQuantity": 123,
  "labelerName": "<string>",
  "listingDate": "2023-11-07T05:31:56Z",
  "lotNumber": "<string>",
  "nationalDrugCode": "<string>",
  "nationalDrugCodeNormalized": "<string>",
  "additionalPackageNotes": "<string>",
  "packageName": "<string>",
  "paymentConfirmedDate": "2023-11-07T05:31:56Z",
  "price": 123,
  "pricePerQuantity": 123,
  "quantity": 123,
  "quantityUnitQualifier": "<string>",
  "sealedPackage": true,
  "sellerPharmacyName": "<string>",
  "sellerPharmacyDBA": "<string>",
  "sellerPharmacyNationalProviderIdentifier": 123,
  "sellerPharmacyPhone": 123,
  "sellerPharmacyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "shippingConfirmDate": "2023-11-07T05:31:56Z",
  "shippingReceivedConfirmDate": "2023-11-07T05:31:56Z",
  "soldDate": "2023-11-07T05:31:56Z",
  "tornPackageLabel": true,
  "sellerPharmacyAddress": {
    "city": "<string>",
    "line1": "<string>",
    "line2": "<string>",
    "postalCode": "<string>",
    "stateAcronym": "<string>"
  },
  "shipByDate": "2023-11-07T05:31:56Z",
  "branded": true,
  "generic": true,
  "gtin": "<string>",
  "serialNumber": "<string>",
  "referralGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "stateGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resultingMarketplaceListingRequestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "statusCode": 123,
  "message": "<string>"
}

Authorizations

X-INVIEW-AUTH

string

header

required

Custom API Key authentication. Default header: X-INVIEW-AUTH.

Path Parameters

string<uuid>

required

The unique identifier of the marketplace listing to update.

Body

The update model containing the new listing details.

pharmacyNPI

integer<int64> | null

expirationDate

string | null

fullPackage

boolean | null

lotNumber

string | null

sealedPackage

boolean | null

originalPackage

boolean

tornPackageLabel

boolean

serialNumber

string | null

additionalPackageNotes

string | null

price

number<double>

quantity

number<double>

showOnlyInState

boolean

Response

Success

buyerPharmacyName

string | null

buyerPharmacyNationalProviderIdentifier

integer<int64> | null

buyersMessage

string | null

buyingPharmacyAddress

object | null

Show child attributes

buyingPharmacyName

string | null

buyingPharmacyDBA

string | null

buyingPharmacyPhone

integer<int64> | null

cancellationDescription

string | null

cancellationReason

enum<integer> | null

Available options:

1,

2,

3,

4,

5

cancelledDate

string<date-time> | null

drugPackageForm

string | null

drugPackageStrength

string | null

expirationDate

string<date-time> | null

fullPackage

boolean

originalPackage

boolean

string<uuid> | null

inventoryQuantity

number<double>

labelerName

string | null

listingDate

string<date-time> | null

lotNumber

string | null

nationalDrugCode

string | null

nationalDrugCodeNormalized

string | null

additionalPackageNotes

string | null

packageName

string | null

paymentConfirmedDate

string<date-time> | null

price

number<double> | null

pricePerQuantity

number<double> | null

quantity

number<double>

quantityUnitQualifier

string | null

sealedPackage

boolean

sellerPharmacyName

string | null

sellerPharmacyDBA

string | null

sellerPharmacyNationalProviderIdentifier

integer<int64> | null

sellerPharmacyPhone

integer<int64> | null

sellerPharmacyId

string<uuid>

shippingConfirmDate

string<date-time> | null

shippingReceivedConfirmDate

string<date-time> | null

soldDate

string<date-time> | null

tornPackageLabel

boolean

sellerPharmacyAddress

object | null

Show child attributes

status

enum<integer> | null

Available options:

0,

1,

2,

5,

6,

7,

10

shipByDate

string<date-time> | null

branded

boolean | null

generic

boolean | null

gtin

string | null

serialNumber

string | null

deliveryStatus

enum<integer>

Available options:

0,

1,

2,

3,

4,

5,

6,

7,

8,

9

referralGroupId

string<uuid> | null

stateGroupId

string<uuid> | null

resultingMarketplaceListingRequestId

string<uuid> | null

Overview

Endpoints

Update marketplace listing

Validation Rules

Authorizations

Path Parameters

Body

Response