GET api/v1/{EMRSystem}/References/Pharmacies

Returns the Pharmacies built in the EMR.

Status: Released

URI Parameters

NameDescriptionTypeAdditional information
EMRSystem

The emr system.

EMRSystem

None.

UserId

The identifier of the user requesting the list of pharmacies

string

None.

TypeIds

Comma delimited list of pharmacy type identifiers to search for.

string

None.

Name

Pharmacy name to search for

string

None.

NCPDP

Pharmacy NCPDP (National Council for Prescription Drug Programs) number to search for

string

None.

City

City in which to search for pharmacies

string

None.

State

State in which to search for pharmacies

string

None.

Zip

Zip code in which to search for pharmacies

string

None.

Header Parameters

NameDescriptionTypeAdditional information
LoginId

Gets or sets the login identifier. This Login Id will be encrypted and passed in Sansoro specific Http Request Headers.

string

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox

Password

Gets or sets the password. This Password will be encrypted and passed in Sansoro specific Http Request Headers.

string

Data type: Password

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox

EmrInstance

Gets or sets the emr instance. This emr instance info will be encrypted and passed in Sansoro specific Http Request Headers.

string

None.

ApplicationName

Gets or sets the requesting application name. This requesting application name will be encrypted and passed in Sansoro specific Http Request Headers.

string

Required if using application keys

ApplicationKey

Gets or sets the requesting application key. This requesting application key will be encrypted and passed in Sansoro specific Http Request Headers.

string

Data type: Password

Required if using application keys

AuthorizationToken

Gets or sets the custom authorization token. This requesting authorization token will be encrypted and passed in Sansoro specific Http Request Headers.

string

None.

RequestVerboseLogging

Enables verbose logging for a single request. When "true", verbose logging will occur. When "false", the configuration setting will be respected. This value will be passed in Sansoro specific Http Request Headers.

boolean

None.

Response Information

Collection of UdmPharmacyDiscoveryResponse
NameDescriptionTypeAdditional information
Id

The pharmacy identifier

string

None.

Name

The pharmacy name

string

None.

NCPDP

The pharmacy NCPDP (National Council for Prescription Drug Programs) number

string

None.

PharmacyTypes

List of pharmacy types for this pharmacy

Collection of CodedObject

None.

IsEPrescribing

Is the pharamcy capable of e-prescribing

boolean

None.

Address

The phamacy's address

Address

None.

Phones

List of the pharmacy's phone numbers

Collection of Phone

None.

Response Codes

Http Status Code 200 - Indicates that the request was processed successfully.

Http Status Code 400 - Indicates that the request did not contain all the required fields or had an invalid value.

Http Status Code 401 - Indicates that authentication to the underlying EMR server using the provided LoginId and Password failed.

Http Status Code 403 - Indicates that there is an issue with the request UserId.

Http Status Code 408 - Indicates that the request to the underlying EMR server timed out.

Http Status Code 500 - Indicates that an internal server error occurred during processing of the request.

Http Status Code 502 - Indicates that a request made to the underlying EMR server could not be completed.

Response Formats

application/json

[
  {
    "Id": "sample string 1",
    "Name": "sample string 2",
    "NCPDP": "sample string 3",
    "PharmacyTypes": [
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      }
    ],
    "IsEPrescribing": true,
    "Address": {
      "AddressId": "sample string 1",
      "Address1": "sample string 2",
      "Address2": "sample string 3",
      "Address3": "sample string 4",
      "City": "sample string 5",
      "State": "sample string 6",
      "ZIP": "sample string 7",
      "Type": "sample string 8",
      "TypeId": "sample string 9",
      "SequenceNumber": "sample string 10",
      "Country": "sample string 11",
      "County": "sample string 12",
      "EndEffectiveDateTime": "2025-12-12T20:52:23.1415012+00:00"
    },
    "Phones": [
      {
        "PhoneId": "sample string 1",
        "Number": "sample string 2",
        "SequenceNumber": "sample string 3",
        "Type": "sample string 4",
        "TypeId": "sample string 5",
        "Extension": "sample string 6",
        "EndEffectiveDateTime": "2025-12-12T20:52:23.1415545+00:00",
        "Format": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      },
      {
        "PhoneId": "sample string 1",
        "Number": "sample string 2",
        "SequenceNumber": "sample string 3",
        "Type": "sample string 4",
        "TypeId": "sample string 5",
        "Extension": "sample string 6",
        "EndEffectiveDateTime": "2025-12-12T20:52:23.1415545+00:00",
        "Format": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      }
    ]
  },
  {
    "Id": "sample string 1",
    "Name": "sample string 2",
    "NCPDP": "sample string 3",
    "PharmacyTypes": [
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      }
    ],
    "IsEPrescribing": true,
    "Address": {
      "AddressId": "sample string 1",
      "Address1": "sample string 2",
      "Address2": "sample string 3",
      "Address3": "sample string 4",
      "City": "sample string 5",
      "State": "sample string 6",
      "ZIP": "sample string 7",
      "Type": "sample string 8",
      "TypeId": "sample string 9",
      "SequenceNumber": "sample string 10",
      "Country": "sample string 11",
      "County": "sample string 12",
      "EndEffectiveDateTime": "2025-12-12T20:52:23.1415012+00:00"
    },
    "Phones": [
      {
        "PhoneId": "sample string 1",
        "Number": "sample string 2",
        "SequenceNumber": "sample string 3",
        "Type": "sample string 4",
        "TypeId": "sample string 5",
        "Extension": "sample string 6",
        "EndEffectiveDateTime": "2025-12-12T20:52:23.1415545+00:00",
        "Format": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      },
      {
        "PhoneId": "sample string 1",
        "Number": "sample string 2",
        "SequenceNumber": "sample string 3",
        "Type": "sample string 4",
        "TypeId": "sample string 5",
        "Extension": "sample string 6",
        "EndEffectiveDateTime": "2025-12-12T20:52:23.1415545+00:00",
        "Format": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      }
    ]
  }
]

'

GET api/v1/{EMRSystem}/References/Pharmacies

Returns the Pharmacies built in the EMR.

Status: Released

URI Parameters


Header Parameters

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
Data type: Password , Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
Required if using application keys
Data type: Password , Required if using application keys

Request: {{ method }} {{ url }}

  • Http Request Headers
  • {{header.name}} : {{header.value}} ******
  • Http Request Body
  • {{httpRequestBody}}
  • Http Response Headers
  • {{header.name}} : {{header.value}} ******
  • Http Response Data
  • {{httpResponseData}}