Requisitions

Get the list of Requisitions

Path

GET /odata/Requisitions

Description

Returns a paged list of existing Requisitions.

Note

You can filter the results as follows:

• For an exact match, use: $filter parameter–entity eq ‘string’
• For a partial match, use: $filter=contains parameter–contains(entity, ‘string’)

Request parameters

Parameter	Explanation
api-version: string default: 1.0 in header	The requested API version.
$filter: string in query	Restricts the set of items returned. The maximum number of expressions is 100.
$orderby: string in query	Specifies the order in which items are returned. The maximum number of expressions is 5.
$search: string in query	Picks the value in all possible fields.
$top: string in query	Returns only the first n results.
$skip: string in query	Skips the first n results.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	Incorrect input data or organization ID does not match with the organization ID user is logged in.
400 Bad Request	The limit for the $top query has been exceeded. The value from the incoming request is 'N' (N is your value from the request). You can find the data on the current limit here.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.

Properties

Property	Explanation
requisitionId: string (uuid)	Unique Identifier of the Requisition
requisitionNo: string	Identification code of the Requisition
requisitionTypeId: integer (int32)	Unique Identifier of the Requisition
requisitionType: string	Type of Requsition
facilityId: string (uuid)	Unique Identifier of the Facility
facilityNo: string	Identification Number of the Facility
facilityName: string	Name of the Facility
patientId: string (uuid)	Unique Identifier of the Patient
departmentId: string (uuid)	Unique Identifier of the Department
departmentNo: string	Number of the Department
departmentName: string	Name of the Department
deliveryLocationId: string (uuid)	Unique Identifier of the Delivery Location
deliveryLocationNo: string	Identification Number of the Delivery Location
deliveryLocationName: string	Name of the Delivery Location
reference: string	Information concerning the Transaction
requisitionerId: string (uuid)	Unique Identifier of the Requisitioner
requisitionerName: string	Name of the Requisitioner
requisitionDate: string (date-time)	Date of the Requsition
requiredDeliveryDate: string (date-time)	Required Delivery Date of the Requisition
requisitionStatusId: integer (int32)	Unique Identifier of the Requisition
requisitionStatus: string	Status of the Requisition
requisitionNotes: string	Comments about the Requisition
buyerName: string	Name of the Buyer
buyerAddress1: string	The first Address of the Buyer for shipping or billing purposes
buyerAddress2: string	The second Address of the Buyer for shipping or billing purposes
buyerCity: string	City of the Buyer
buyerState: string	State of the Buyer
buyerZip: string	Zip of the Buyer
buyerCountry: string	Country of the Buyer
buyerContact: string	Contact of the Buyer
buyerContactEmail: string	Contact Email of the Buyer
buyerPhone: string	Phone of the Buyer
buyerFax: string	Fax of the Buyer
shippingName: string	Name of the Shipping
shippingAddress1: string	The First Address for sending the Requisition
shippingAddress2: string	The Second Address for sending the Requisition
shippingCity: string	City for sending the Requisition
shippingState: string	State for sending the Requisition
shippingZip: string	Zip for sending the Requisition
shippingCountry: string	Country for sending the Requisition
shippingContact: string	Contact for sending the Requisition
shippingContactEmail: string	Contact Email for sending the Requisition
shippingPhone: string	Phone for sending the Requisition
shippingPhoneExt: string	Phone Extension for sending the Requisition
shippingFax: string	Fax for sending the Requisition
discount: number (double)	Discount for the Requisition
discountTypeId: integer (int32)	Unique Identifier of the Discount Type for the Requisition
discountType: string	Type of the discount for the Requisition
salesTax: string	Tax for the Sales
salesTaxTypeId: string	Unique Identifier of the Tax for the Sales
shipping: number (double)	Number of the Shipping
shippingTypeId: integer (int32)	Unique Identifier of the Shipping Type
shippingType: string	Type of the Shipping
dateSubmitted: string (date-time)	Date when the Requisition was submitted
dateCreated: string (date-time)	Date when the Requisition was created
createdBy: string (uuid)	Unique Identifier of the user who created the Requsition
createdByName: string	Name of the user who created the Requisition
lastUpdated: string (date-time)	Last Date when the Requisition was updated
lastUpdatedBy: string (date-time)	Unique Identifier of the last user who updated the Requisition
lastUpdatedByName: string	Name of the last user who updated the Requisition
requisitionSourceId: integer (int32)	Unique Identifier of the Requisition
requisitionSource: string	Source of the Requisition
notes: string	Comments about the Requisition
submittedBy: string (uuid)	Unique Identifier of the user who submitted the Requisition
submittedByName: string	Name of the user who submitted the Requisition
isCanceled: boolean	Is the Requisition canceled or not?
parAreaId: string (uuid)	Unique Identifier of the PAR Area
sourceFacilityId: string (uuid)	Unique Identifier of the Facility Source
sourceFacilityNo: string	Number of the Facility Source
sourceFacilityName: string	Name of the Facility Source
statusLastUpdated: string (date-time)	Last Date when the Status of the Facility Source was updated
statusLastUpdatedBy: string (uuid)	Unique Identifier of the last user who updated the Status of the Facility Source
statusLastUpdatedByName: string	Name of the last user who updated the Status of the Facility Source
isConverted: boolean	Is the Requisition converted or not?
cancelledRemainingQuantities LastUpdated: string (date-time)	Last Date when the Remaining Quantities of the Facility was canceled and updated
cancelledRemaining QuantitiesBy: string (uuid)	Unique Identifier of the user who canceled the Remaining Quantities of the Facility
cancelledRemaining QuantitiesByName: string	Name of the user who updated the Remaining Quantities of the Facility

Response Content-types: APPLICATION/JSON, APPLICATION/XML
Response example (200 OK)

{
    "@odata.context": "link",
    "@odata.count": "number",
    "value": [
        {
            "requisitionId": "00000000-0000-0000-0000-000000000000",
            "requisitionNo": "string",
            "requisitionTypeId": "integer (int32)",
            "requisitionType": "string",
            "facilityId": "00000000-0000-0000-0000-000000000000",
            "facilityNo": "string",
            "facilityName": "string",
            "patientId": "00000000-0000-0000-0000-000000000000",
            "departmentId": "00000000-0000-0000-0000-000000000000",
            "departmentNo": "string",
            "departmentName": "string",
            "deliveryLocationId": "00000000-0000-0000-0000-000000000000",
            "deliveryLocationNo": "string",
            "deliveryLocationName": "string",
            "reference": "string",
            "requisitionerId": "00000000-0000-0000-0000-000000000000",
            "requisitionerName": "string",
            "requisitionDate": "string (date-time)",
            "requiredDeliveryDate": "string (date-time)",
            "requisitionStatusId": "integer (int32)",
            "requisitionStatus": "string",
            "requisitionNotes": "string",
            "buyerName": "string",
            "buyerAddress1": "string",
            "buyerAddress2": "string",
            "buyerCity": "string",
            "buyerState": "string",
            "buyerZip": "string",
            "buyerCountry": "string",
            "buyerContact": "string",
            "buyerContactEmail": "string",
            "buyerPhone": "string",
            "buyerPhoneExt": "string",
            "buyerFax": "string",
            "shippingName": "string",
            "shippingAddress1": "string",
            "shippingAddress2": "string",
            "shippingCity": "string",
            "shippingState": "string",
            "shippingZip": "string",
            "shippingCountry": "string",
            "shippingContact": "string",
            "shippingContactEmail": "string",
            "shippingPhone": "string",
            "shippingPhoneExt": "string",
            "shippingFax": "string",
            "discount": "number (double)",
            "discountTypeId": "integer (int32)",
            "discountType": "string",
            "salesTax": "number (double)",
            "salesTaxTypeId": "integer (int32)",
            "salesTaxType": "string",
            "shipping": "number (double)",
            "shippingTypeId": "integer (int32)",
            "shippingType": "string",
            "dateSubmitted": "string (date-time)",
            "dateCreated": "string (date-time)",
            "createdBy": "00000000-0000-0000-0000-000000000000",
            "createdByName": "string",
            "lastUpdated": "string (date-time)",
            "lastUpdatedBy": "00000000-0000-0000-0000-000000000000",
            "lastUpdatedByName": "string",
            "requisitionSourceId": "integer (int32)",
            "requisitionSource": "string",
            "notes": "string",
            "submittedBy": "00000000-0000-0000-0000-000000000000",
            "submittedByName": "string",
            "isCanceled": "boolean",
            "parAreaId": "00000000-0000-0000-0000-000000000000",
            "sourceFacilityId": "00000000-0000-0000-0000-000000000000",
            "sourceFacilityNo": "string",
            "sourceFacilityName": "string",
            "statusLastUpdated": "string (date-time)",
            "statusLastUpdatedBy": "00000000-0000-0000-0000-000000000000",
            "statusLastUpdatedByName": "string",
            "isConverted": "boolean",
            "cancelledRemainingQuantitiesLastUpdated": "string (date-time)",
            "cancelledRemainingQuantitiesBy": "00000000-0000-0000-0000-000000000000",
            "cancelledRemainingQuantitiesByName": "string"
        }
    ],
    "@odata.nextLink": "link"
}

Create a new Standard Requisition

Path

POST /odata/Requisitions

Description

Creates a new Standard Requisition within the logged-in organization.

Request body

Parameter	Explanation
facilityNo: string required in path	Identification Number of the Facility
departmentNo: string required in path	Identification Number of the Department
patientId: string (uuid)	Unique Identifier of the Patient
reference: string	Information concerning the Transaction

Request Content-types: APPLICATION/JSON, APPLICATION/XML
Request Example

{
    "facilityNo": "string",
    "departmentNo": "string",
    "patientId": "00000000-0000-0000-0000-000000000000",
    "reference": "string"
}   

Request parameters

Parameter	Explanation
api-version: string default: 1.0 in header	The requested API version.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	Incorrect input data or organization ID does not match with the organization ID user is logged in.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.

Response Content-types: APPLICATION/JSON, APPLICATION/XML
Request Example

"00000000-0000-0000-0000-000000000000"

Get the specified Requisition

Path

GET /odata/Requisitions({requisitionId})

Description

Returns the details of the Requisition specified by ID.

Request parameters

Parameter	Explanation
requisitionId: string (uuid) required in path	Enter the ID of the Requisition here.
api-version: string default: 1.0 in header	The requested API version.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	Incorrect input data or organization ID does not match with the organization ID user is logged in.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
404 Not Found	Specified ID is absent in the system.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.

Properties

Property	Explanation
requisitionId: string (uuid)	Unique Identifier of the Requisition
requisitionNo: string	Identification code of the Requisition
requisitionTypeId: integer (int32)	Unique Identifier of the Requisition
requisitionType: string	Type of Requsition
facilityId: string (uuid)	Unique Identifier of the Facility
facilityNo: string	Identification Number of the Facility
facilityName: string	Name of the Facility
patientId: string (uuid)	Unique Identifier of the Patient
departmentId: string (uuid)	Unique Identifier of the Department
departmentNo: string	Number of the Department
departmentName: string	Name of the Department
deliveryLocationId: string (uuid)	Unique Identifier of the Delivery Location
deliveryLocationNo: string	Identification Number of the Delivery Location
deliveryLocationName: string	Name of the Delivery Location
reference: string	Information concerning the Transaction
requisitionerId: string (uuid)	Unique Identifier of the Requisitioner
requisitionerName: string	Name of the Requisitioner
requisitionDate: string (date-time)	Date of the Requsition
requiredDeliveryDate: string (date-time)	Required Delivery Date of the Requisition
requisitionStatusId: integer (int32)	Unique Identifier of the Requisition
requisitionStatus: string	Status of the Requisition
requisitionNotes: string	Comments about the Requisition
buyerName: string	Name of the Buyer
buyerAddress1: string	The first Address of the Buyer for shipping or billing purposes
buyerAddress2: string	The second Address of the Buyer for shipping or billing purposes
buyerCity: string	City of the Buyer
buyerState: string	State of the Buyer
buyerZip: string	Zip of the Buyer
buyerCountry: string	Country of the Buyer
buyerContact: string	Contact of the Buyer
buyerContactEmail: string	Contact Email of the Buyer
buyerPhone: string	Phone of the Buyer
buyerFax: string	Fax of the Buyer
shippingName: string	Name of the Shipping
shippingAddress1: string	The First Address for sending the Requisition
shippingAddress2: string	The Second Address for sending the Requisition
shippingCity: string	City for sending the Requisition
shippingState: string	State for sending the Requisition
shippingZip: string	Zip for sending the Requisition
shippingCountry: string	Country for sending the Requisition
shippingContact: string	Contact for sending the Requisition
shippingContactEmail: string	Contact Email for sending the Requisition
shippingPhone: string	Phone for sending the Requisition
shippingPhoneExt: string	Phone Extension for sending the Requisition
shippingFax: string	Fax for sending the Requisition
discount: number (double)	Discount for the Requisition
discountTypeId: integer (int32)	Unique Identifier of the Discount Type for the Requisition
discountType: string	Type of the discount for the Requisition
salesTax: string	Tax for the Sales
salesTaxTypeId: string	Unique Identifier of the Tax for the Sales
shipping: number (double)	Number of the Shipping
shippingTypeId: integer (int32)	Unique Identifier of the Shipping Type
shippingType: string	Type of the Shipping
dateSubmitted: string (date-time)	Date when the Requisition was submitted
dateCreated: string (date-time)	Date when the Requisition was created
createdBy: string (uuid)	Unique Identifier of the user who created the Requsition
createdByName: string	Name of the user who created the Requisition
lastUpdated: string (date-time)	Last Date when the Requisition was updated
lastUpdatedBy: string (date-time)	Unique Identifier of the last user who updated the Requisition
lastUpdatedByName: string	Name of the last user who updated the Requisition
requisitionSourceId: integer (int32)	Unique Identifier of the Requisition
requisitionSource: string	Source of the Requisition
notes: string	Comments about the Requisition
submittedBy: string (uuid)	Unique Identifier of the user who submitted the Requisition
submittedByName: string	Name of the user who submitted the Requisition
isCanceled: boolean	Is the Requisition canceled or not?
parAreaId: string (uuid)	Unique Identifier of the PAR Area
sourceFacilityId: string (uuid)	Unique Identifier of the Facility Source
sourceFacilityNo: string	Number of the Facility Source
sourceFacilityName: string	Name of the Facility Source
statusLastUpdated: string (date-time)	Last Date when the Status of the Facility Source was updated
statusLastUpdatedBy: string (uuid)	Unique Identifier of the last user who updated the Status of the Facility Source
statusLastUpdatedByName: string	Name of the last user who updated the Status of the Facility Source
isConverted: boolean	Is the Facility Source converted or not?
cancelledRemainingQuantities LastUpdated: string (date-time)	Last Date when the Remaining Quantities of the Facility Source was canceled and updated
cancelledRemaining QuantitiesBy: string (uuid)	Unique Identifier of the user who canceled the Remaining Quantities of the Facility Source
cancelledRemaining QuantitiesByName: string	Name of the user who updated the Remaining Quantities of the Facility Source

Response Content-types: APPLICATION/JSON, APPLICATION/XML
Response example (200 OK)

{
    "@odata.context": "link",
    "requisitionId": "00000000-0000-0000-0000-000000000000",
    "requisitionNo": "string",
    "requisitionTypeId": "integer (int32)",
    "requisitionType": "string",
    "facilityId": "00000000-0000-0000-0000-000000000000",
    "facilityNo": "string",
    "facilityName": "string",
    "patientId": "00000000-0000-0000-0000-000000000000",
    "departmentId": "00000000-0000-0000-0000-000000000000",
    "departmentNo": "string",
    "departmentName": "string",
    "deliveryLocationId": "00000000-0000-0000-0000-000000000000",
    "deliveryLocationNo": "string",    
    "deliveryLocationName": "string",
    "reference": "string",    
    "requisitionerId": "00000000-0000-0000-0000-000000000000",
    "requisitionerName": "string",
    "requisitionDate": "string (date-time)",
    "requiredDeliveryDate": "string (date-time)",
    "requisitionStatusId": "integer (int32)",
    "requisitionStatus": "string",
    "requisitionNotes": "string",
    "buyerName": "string",
    "buyerAddress1": "string",
    "buyerAddress2": "string",
    "buyerCity": "string",
    "buyerState": "string",
    "buyerZip": "string",
    "buyerCountry": "string",
    "buyerContact": "string",
    "buyerContactEmail": "string",
    "buyerPhone": "string",
    "buyerPhoneExt": "string",
    "buyerFax": "string",
    "shippingName": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingState": "string",
    "shippingZip": "string",
    "shippingCountry": "string",
    "shippingContact": "string",
    "shippingContactEmail": "string",
    "shippingPhone": "string",
    "shippingPhoneExt": "string",
    "shippingFax": "string",
    "discount": "number (double)",
    "discountTypeId": "integer (int32)",
    "discountType": "string",
    "salesTax": "number (double)",
    "salesTaxTypeId": "integer (int32)",
    "salesTaxType": "string",
    "shipping": "number (double)",
    "shippingTypeId": "integer (int32)",
    "shippingType": "string",
    "dateSubmitted": "string (date-time)",
    "dateCreated": "string (date-time)",
    "createdBy": "00000000-0000-0000-0000-000000000000",
    "createdByName": "string",
    "lastUpdated": "string (date-time)",
    "lastUpdatedBy": "00000000-0000-0000-0000-000000000000",
    "lastUpdatedByName": "string",
    "requisitionSourceId": "integer (int32)",
    "requisitionSource": "string",
    "notes": "string",
    "submittedBy": "00000000-0000-0000-0000-000000000000",
    "submittedByName": "string",
    "isCanceled": "boolean",
    "parAreaId": "00000000-0000-0000-0000-000000000000",
    "sourceFacilityId": "00000000-0000-0000-0000-000000000000",
    "sourceFacilityNo": "string",
    "sourceFacilityName": "string",
    "statusLastUpdated": "string (date-time)",
    "statusLastUpdatedBy": "00000000-0000-0000-0000-000000000000",
    "statusLastUpdatedByName": "string",
    "isConverted": "boolean",
    "cancelledRemainingQuantitiesLastUpdated": "string (date-time)",
    "cancelledRemainingQuantitiesBy": "00000000-0000-0000-0000-000000000000",
    "cancelledRemainingQuantitiesByName": "string"
}

Partially update the specified Requisition

Path

PATCH /odata/Requisitions({requisitionId})

Description

Partially updates the Requisition specified by the ID (applicable only for the Standard Requisition type).

Request body

Parameter	Explanation
reference: string	Information concerning the Transaction
notes: string	Comments about the Requisition
requisitionDate: string (date-time)	Date of the Requsition
requiredDeliveryDate: string (date-time)	Required Delivery Date of the Requisition
shippingName: string	Name of the Shipping
shippingAddress1: string	The First Address for sending the Requisition
shippingAddress2: string	The Second Address for sending the Requisition
shippingCity: string	City for sending the Requisition
shippingState: string	State for sending the Requisition
shippingZip: string	Zip for sending the Requisition
shippingContact: string	Contact for sending the Requisition
shippingPhone: string	Phone for sending the Requisition
shippingPhoneExt: string	Phone Extension for sending the Requisition
shippingFax: string	Fax for sending the Requisition
shippingContactEmail: string	Contact Email for sending the Requisition
shippingCountry: string	Country for sending the Requisition
buyerName: string	Name of the Buyer
buyerAddress1: string	The first Address of the Buyer for shipping or billing purposes
buyerAddress2: string	The second Address of the Buyer for shipping or billing purposes
buyerCity: string	City of the Buyer
buyerState: string	State of the Buyer
buyerZip: string	Zip of the Buyer
buyerContact: string	Contact of the Buyer
buyerPhone: string	Phone of the Buyer
buyerPhoneExt: string	Phone Extension of the Buyer
buyerFax: string	Fax of the Buyer
buyerContactEmail: string	Contact Email of the Buyer
buyerCountry: string	Country of the Buyer
requisitionNotes: string	Comments about the Requisition
discount: number (double)	Discount for the Requisition
discountTypeId: integer (int32)	Unique Identifier of the Discount Type for the Requisition
salesTax: number (double)	Tax for the Sales
salesTaxTypeId: integer (int32)	Unique Identifier of the Tax for the Sales
shipping: number (double)	Number of the Shipping
shippingTypeId: integer (int32)	Unique Identifier of the Shipping Type

Request Content-types: APPLICATION/JSON, APPLICATION/XML
Request Example

{
    "reference": "string",
    "notes": "string",
    "requisitionDate": "string (date-time)",
    "requiredDeliveryDate": "string (date-time)",
    "shippingName": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingState": "string",
    "shippingZip": "string",
    "shippingContact": "string",
    "shippingPhone": "string",
    "shippingPhoneExt": "string",
    "shippingFax": "string",
    "shippingContactEmail": "string",
    "shippingCountry": "string",
    "buyerName": "string",
    "buyerAddress1": "string",
    "buyerAddress2": "string",
    "buyerCity": "string",
    "buyerState": "string",
    "buyerZip": "string",
    "buyerContact": "string",
    "buyerPhone": "string",
    "buyerPhoneExt": "string",
    "buyerFax": "string",
    "buyerContactEmail": "string",
    "buyerCountry": "string",
    "requisitionNotes": "string",
    "discount": "number (double)",
    "discountTypeId": "integer (int32)",
    "salesTax": "number (double)",
    "salesTaxTypeId": "integer (int32)",
    "shipping": "number (double)",
    "shippingTypeId": "integer (int32)"
} 

Request parameters

Parameter	Explanation
requisitionId: string (uuid) required in path	Enter the ID of the Requisition here.
api-version: string default: 1.0 in header	The requested API version.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	Incorrect input data or organization ID does not match with the organization ID user is logged in.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
404 Not Found	Specified ID is absent in the system.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.

Change the Requisition status to Open

Path

POST /odata/Requisitions({requisitionId})/Submit

Description

Changes the Requisition status to Open if the specified Requisition has at least one line item.

Request parameters

Parameter	Explanation
requisitionId: string (uuid) required in path	Enter the ID of the Requisition here.
api-version: string default: 1.0 in header	The requested API version.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	The request is incorrect.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
404 Not Found	Specified ID is absent in the system.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.

Cancel an existing Requisition

Path

POST /odata/Requisitions({requisitionId})/Cancel

Description

Cancels the Requisition specified by the ID.

Request parameters

Parameter	Explanation
requisitionId: string (uuid) required in path	Enter the ID of the Requisition here.
api-version: string default: 1.0 in header	The requested API version.
Authorization: string default: Bearer access_token in header	Specify the type of the token (bearer) and then insert the access_token, which was obtained during authentication.

Responses

Response	Explanation
200 OK	OK
400 Bad Request	The request is incorrect.
401 Unauthorized	Incorrect specified access_token or access_token got expired.
403 Forbidden	User doesn’t have appropriate privileges.
500 Internal Server Error	Server encountered an unexpected condition that prevented it from fulfilling the request.