Sign in
Purchase orders

List purchase orders

The List purchase orders endpoint returns a list of purchase orders for a given company's connection.

Purchase orders represent a business's intent to purchase goods or services from a supplier.

Before using this endpoint, you must have retrieved data for the company.

get/companies/{companyId}/data/purchaseOrders

Query parameters

pageinteger
Example:1

Page number. Read more.

pageSizeinteger
Example:100

Number of records to return in a page. Read more.

querystring

Codat query string. Read more.

orderBystring
Example:-modifiedDate

Field to order results by. Read more.

Response

Success

pageNumberinteger required

Current page number.

pageSizeinteger required

Number of items to return in results array.

totalResultsinteger required

Total number of items.

_linksLinks required— unresolved $ref

Example response

{
  "pageNumber": 1,
  "pageSize": 10,
  "totalResults": 1,
  "_links": {
    "self": {
      "href": "/companies/{id}/data/{dataType}"
    },
    "current": {
      "href": "/companies/{id}/data/{dataType}?page=1&pageSize=10"
    }
  }
}

Changes

Changed in 2 of the 51 revisions of this API.10

  • d9d77b1f91321See the full diff
    • ○

      added the optional property allOf[subschema #1]/results/items/allOf[subschema #1]/createdBy to the response with the 200 status

      response-optional-property-added

  • 4bfab0afa6ca9See the full diff
    • ○

      added the optional property validation to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 409 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property validation to the response with the 503 status

      response-optional-property-added