Get a purchase order by ID | Monite Documentation

curl https://api.sandbox.monite.com/v1/payable_purchase_orders/purchase_order_id \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>"

{
  "id": "id",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "counterpart": {
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "created_automatically": true,
    "created_by_entity_user_id": "created_by_entity_user_id",
    "default_billing_address_id": "default_billing_address_id",
    "default_shipping_address_id": "default_shipping_address_id",
    "individual": {
      "email": "asingh@example.net",
      "first_name": "Adnan",
      "is_customer": true,
      "is_vendor": true,
      "last_name": "Singh",
      "phone": "5553211234",
      "title": "Mr."
    },
    "language": "ab",
    "reminders_enabled": true,
    "tax_id": "tax_id",
    "type": "individual"
  },
  "counterpart_id": "counterpart_id",
  "currency": "AED",
  "document_id": "document_id",
  "entity": {
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "address": {
      "city": "city",
      "country": "AF",
      "line1": "line1",
      "line2": "line2",
      "postal_code": "postal_code",
      "state": "state"
    },
    "email": "email",
    "individual": {
      "date_of_birth": "date_of_birth",
      "first_name": "first_name",
      "id_number": "id_number",
      "last_name": "last_name",
      "ssn_last_4": "ssn_last_4",
      "title": "title"
    },
    "logo": {
      "id": "id",
      "created_at": "2024-01-15T09:30:00Z",
      "file_type": "payables",
      "md5": "31d1a2dd1ad3dfc39be849d70a68dac0",
      "mimetype": "application/pdf",
      "name": "invoice.pdf",
      "pages": [
        {
          "id": "id",
          "mimetype": "image/png",
          "number": 0,
          "size": 21972,
          "url": "https://bucket.s3.amazonaws.com/123/456.png"
        }
      ],
      "previews": [
        {
          "height": 400,
          "url": "https://bucketname.s3.amazonaws.com/1/2/3.png",
          "width": 200
        }
      ],
      "region": "eu-central-1",
      "size": 24381,
      "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf"
    },
    "phone": "phone",
    "status": "active",
    "tax_id": "tax_id",
    "website": "website"
  },
  "entity_id": "entity_id",
  "items": [
    {
      "currency": "AED",
      "name": "name",
      "price": 1,
      "quantity": 1,
      "unit": "unit",
      "vat_rate": 1
    }
  ],
  "message": "message",
  "status": "status",
  "valid_for_days": 1,
  "counterpart_address": {
    "city": "Berlin",
    "country": "AF",
    "line1": "Flughafenstrasse 52",
    "postal_code": "10115",
    "line2": "line2",
    "state": "state"
  },
  "counterpart_address_id": "counterpart_address_id",
  "created_by_user_id": "created_by_user_id",
  "entity_vat_id": {
    "id": "id",
    "country": "country",
    "entity_id": "entity_id",
    "type": "type",
    "value": "value"
  },
  "file_id": "file_id",
  "file_url": "file_url",
  "issued_at": "issued_at",
  "project_id": "project_id"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

purchase_order_idstringRequired

Response

Successful Response

idstringformat: "uuid"

A unique ID assigned to this purchase order.

created_atdatetime

Time at which the receivable was created. Timestamps follow the ISO 8601 standard.

updated_atdatetime

Time at which the receivable was last updated. Timestamps follow the ISO 8601 standard.

counterpartobject

Counterpart information about an organization (juridical person) or individual (natural person) that provides goods and services to or buys them from an

counterpart_idstringformat: "uuid"

Counterpart unique ID.

currencyenum

The currency in which the price of the product is set. (all items need to have the same currency)

document_idstring

entityobject

Data of the entity (address, name, contact)

entity_idstringformat: "uuid"

The ID of the entity which issued the purchase order.

itemslist of objects

List of item to purchase

messagestring

Msg which will be send to counterpart for who the purchase order is issued.

statusstring

Purchase order can be in 'draft' state before sending it to counterpart. After that state is 'issued'

valid_for_daysinteger>=1

Number of days for which purchase order is valid

counterpart_addressobject

Counterpart address data saved on creation or update of the purchase order.

counterpart_address_idstringformat: "uuid"

The ID of counterpart address object stored in counterparts service. If not provided, counterpart's default address is used.

created_by_user_idstringformat: "uuid"

ID of the creator of the purchase order

entity_vat_idobject

file_idstringformat: "uuid"

file_urlstring

issued_atstringformat: "date"

When status changed from 'draft' to 'send', so after sending purchase order

project_idstringformat: "uuid"

Project ID of a purchase order

Errors

400

Get Payable Purchase Orders ID Request Bad Request Error

401

Get Payable Purchase Orders ID Request Unauthorized Error

404

Get Payable Purchase Orders ID Request Not Found Error

422

Get Payable Purchase Orders ID Request Unprocessable Entity Error

429

Get Payable Purchase Orders ID Request Too Many Requests Error

Authentication

Path parameters

Headers

Response

Errors