Skip to main content
GET
/
receivables
Get receivables
curl --request GET \
  --url https://api.sandbox.monite.com/v1/receivables \
  --header 'Authorization: Bearer <token>' \
  --header 'x-monite-entity-id: <x-monite-entity-id>' \
  --header 'x-monite-version: <x-monite-version>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "counterpart_address": {
        "city": "Berlin",
        "country": "DE",
        "line1": "Flughafenstrasse 52",
        "postal_code": "10115",
        "line2": "<string>",
        "state": "<string>"
      },
      "counterpart_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "counterpart_type": "individual",
      "currency": "AED",
      "entity": {
        "name": "<string>",
        "type": "organization",
        "email": "jsmith@example.com",
        "logo": "<string>",
        "phone": "<string>",
        "registration_authority": "<string>",
        "registration_number": "<string>",
        "tax_id": "<string>",
        "vat_id": "<string>",
        "website": "<string>"
      },
      "entity_address": {
        "city": "<string>",
        "line1": "<string>",
        "postal_code": "<string>",
        "country": "DE",
        "line2": "<string>",
        "state": "<string>"
      },
      "file_language": "ab",
      "line_items": [
        {
          "product": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z",
            "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "price": {
              "currency": "AED",
              "value": 4503599627370495
            },
            "price_after_vat": {
              "currency": "AED",
              "value": 4503599627370495
            },
            "vat_rate": {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "country": "DE",
              "value": 5000,
              "components": [
                {
                  "name": "<string>",
                  "value": 5000
                }
              ],
              "created_by": "monite",
              "status": "active",
              "valid_from": "2023-12-25",
              "valid_until": "2023-12-25"
            },
            "accounting_tax_rate_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "description": "<string>",
            "entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "external_reference": "<string>",
            "is_inline": false,
            "ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "measure_unit": {
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "name": "<string>",
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "description": "<string>"
            },
            "measure_unit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "smallest_amount": 1073741823.5,
            "type": "product"
          },
          "quantity": 1073741823.5,
          "total_after_vat": 123,
          "total_before_vat": 123,
          "discount": {
            "amount": 4503599627370495,
            "type": "amount"
          },
          "tax_status": "taxable"
        }
      ],
      "original_file_language": "ab",
      "status": "draft",
      "total_vat_amount": 123,
      "type": "quote",
      "attachments": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "mimetype": "<string>",
          "name": "<string>",
          "size": 123,
          "url": "<string>",
          "include_in_email": false
        }
      ],
      "based_on": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "based_on_document_id": "<string>",
      "comment": "<string>",
      "commercial_condition_description": "<string>",
      "counterpart_billing_address": {
        "city": "Berlin",
        "country": "DE",
        "line1": "Flughafenstrasse 52",
        "postal_code": "10115",
        "line2": "<string>",
        "state": "<string>"
      },
      "counterpart_business_type": "<string>",
      "counterpart_contact": {
        "address": {
          "city": "Berlin",
          "country": "DE",
          "line1": "Flughafenstrasse 52",
          "postal_code": "10115",
          "line2": "<string>",
          "state": "<string>"
        },
        "first_name": "Marge",
        "last_name": "Smith",
        "email": "marge@example.org",
        "phone": "55512378654",
        "title": "Dr."
      },
      "counterpart_external_reference": "<string>",
      "counterpart_name": "<string>",
      "counterpart_shipping_address": {
        "city": "Berlin",
        "country": "DE",
        "line1": "Flughafenstrasse 52",
        "postal_code": "10115",
        "line2": "<string>",
        "state": "<string>"
      },
      "counterpart_tax_id": "<string>",
      "counterpart_vat_id": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "counterpart_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "value": "123456789",
        "country": "AF",
        "type": "eu_vat"
      },
      "deduction_amount": 4503599627370495,
      "deduction_memo": "<string>",
      "deductions": [
        {
          "amount": 4503599627370495,
          "name": "<string>",
          "memo": "<string>"
        }
      ],
      "discount": {
        "amount": 4503599627370495,
        "type": "amount",
        "value": 4503599627370495
      },
      "discounted_subtotal": 123,
      "document_id": "<string>",
      "document_rendering": {
        "credit_note": {
          "display_entity_bank_account": true
        },
        "display_entity_bank_account": true,
        "display_line_items": true,
        "invoice": {
          "display_entity_bank_account": true
        },
        "line_items": {
          "discount": {
            "display": true,
            "label": "<string>"
          },
          "measure_unit": {
            "display": true,
            "label": "<string>"
          },
          "name": {
            "display": true,
            "label": "<string>"
          },
          "price": {
            "display": true,
            "label": "<string>",
            "precision": 3
          },
          "price_after_vat": {
            "display": true,
            "label": "<string>",
            "precision": 3
          },
          "quantity": {
            "display": true,
            "label": "<string>"
          },
          "total_price": {
            "display": true,
            "label": "<string>",
            "precision": 3
          },
          "total_price_after_vat": {
            "display": true,
            "label": "<string>",
            "precision": 3
          },
          "vat_amount": {
            "display": false
          },
          "vat_rate": {
            "display": true,
            "label": "<string>",
            "precision": 3
          }
        },
        "quote": {
          "display_entity_bank_account": true,
          "display_signature": false
        }
      },
      "due_date": "2023-12-25",
      "einvoice_file_url": "<string>",
      "entity_bank_account": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "account_holder_name": "<string>",
        "account_number": "<string>",
        "bank_name": "<string>",
        "bic": "<string>",
        "country": "AF",
        "currency": "AED",
        "display_name": "<string>",
        "iban": "<string>",
        "is_default": false,
        "routing_number": "<string>",
        "sort_code": "<string>",
        "was_created_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity_vat_id": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "country": "AF",
        "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "value": "123456789",
        "type": "eu_vat"
      },
      "expiry_date": "2023-12-25",
      "file": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "created_at": "2023-11-07T05:31:56Z",
        "file_type": "payables",
        "md5": "31d1a2dd1ad3dfc39be849d70a68dac0",
        "mimetype": "application/pdf",
        "name": "invoice.pdf",
        "region": "eu-central-1",
        "size": 24381,
        "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf",
        "pages": [],
        "previews": []
      },
      "file_url": "<string>",
      "footer": "<string>",
      "issue_date": "2023-11-07T05:31:56Z",
      "memo": "<string>",
      "original_file_url": "<string>",
      "partner_metadata": {},
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quote_accept_page_url": "<string>",
      "signature_required": true,
      "subtotal": 123,
      "subtotal_after_vat": 123,
      "tags": [],
      "total_amount": 0,
      "total_deduction_amount": 123,
      "total_vat_amounts": [
        {
          "amount": 4503599627370495,
          "taxable_amount": 1,
          "value": 5000,
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "components": [
            {
              "amount": 4503599627370495,
              "name": "<string>",
              "value": 5000
            }
          ],
          "name": "<string>"
        }
      ],
      "total_withholding_tax": 123,
      "trade_name": "<string>",
      "vat_exempt": true,
      "vat_exemption_rationale": "<string>",
      "vat_inclusive_discount_mode": "exclusive",
      "vat_mode": "exclusive",
      "withholding_tax_rate": 5000
    }
  ],
  "next_pagination_token": "<string>",
  "prev_pagination_token": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-monite-version
string<date>
required
​
x-monite-entity-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Query Parameters

​
order
enum<string>
default:asc

Sort order (ascending by default). Typically used together with the sort parameter.

Available options:
asc,
desc
​
limit
integer
default:100

The number of items (0 .. 250) to return in a single page of the response. Default is 100. The response may contain fewer items if it is the last or only page.

When using pagination with a non-default limit, you must provide the limit value alongside pagination_token in all subsequent pagination requests. Unlike other query parameters, limit is not inferred from pagination_token.

Required range: 1 <= x <= 250
​
pagination_token
string

A pagination token obtained from a previous call to this endpoint. Use it to get the next or previous page of results for your initial query. If pagination_token is specified, all other query parameters except limit are ignored and inferred from the initial query.

If not specified, the first page of results will be returned.

​
id__in
string<uuid>[]

Return only receivables with the specified IDs. Valid but nonexistent IDs do not raise errors but produce no results.

To specify multiple IDs, repeat this parameter for each value: id__in=<id1>&id__in=<id2>

​
status__in
enum<string>[]

Return only receivables that have the specified statuses. See the applicable invoice statuses, quote statuses, and credit note statuses.

To specify multiple statuses, repeat this parameter for each value: status__in=draft&status__in=issued

Available options:
draft,
issuing,
issued,
failed,
accepted,
expired,
declined,
recurring,
partially_paid,
paid,
overdue,
uncollectible,
canceled
​
entity_user_id__in
string<uuid>[]

Return only receivables created by the entity users with the specified IDs.To specify multiple user IDs, repeat this parameter for each ID: entity_user_id__in=<user1>&entity_user_id__in=<user2>

If the request is authenticated using an entity user token, this user must have the receivable.read.allowed (rather than allowed_for_own) permission to be able to query receivables created by other users.

IDs of deleted users will still produce results here if those users had associated receivables. Valid but nonexistent user IDs do not raise errors but produce no results.

​
sort
enum<string>

The field to sort the results by. Typically used together with the order parameter.

Available options:
counterpart_name,
counterpart_id,
amount,
total_amount,
discounted_subtotal,
status,
due_date,
issue_date,
document_id,
created_at,
project_id
​
tag_ids__in
string<uuid>[]

Return only receivables whose tags include at least one of the tags with the specified IDs.

For example, given receivables with the following tags:

  1. tagA
  2. tagB
  3. tagA, tagB
  4. tagC
  5. tagB, tagC

tag_ids__in=<tagA>&tag_ids__in=<tagB> will return receivables 1, 2, 3, and 5.

Valid but nonexistent tag IDs do not raise errors but produce no results.

​
tag_ids
string<uuid>[]

Return only receivables whose tags include all of the tags with the specified IDs and optionally other tags that are not specified.

For example, given receivables with the following tags:

  1. tagA
  2. tagB
  3. tagA, tagB
  4. tagC
  5. tagA, tagB, tagC

tag_ids=<tagA>&tag_ids=<tagB> will return receivables 3 and 5.

​
product_ids__in
string<uuid>[]

Return only receivables whose line items include at least one of the product IDs with the specified IDs.

To specify multiple product IDs, repeat this parameter for each ID: product_ids__in=<product1>&product_ids__in=<product2>

For example, given receivables with the following product IDs:

  1. productA
  2. productB
  3. productA, productB
  4. productC
  5. productB, productC

product_ids__in=<productA>&product_ids__in=<productB> will return receivables 1, 2, 3, and 5.Valid but nonexistent product IDs do not raise errors but produce no results.

​
product_ids
string<uuid>[]

Return only receivables whose line items include all of the product IDs with the specified IDs and optionally other products that are not specified.

To specify multiple product IDs, repeat this parameter for each ID: product_ids=<product1>&product_ids=<product2>

For example, given receivables with the following product IDs:

  1. productA
  2. productB
  3. productA, productB
  4. productC
  5. productA, productB, productC

product_ids=<productA>&product_ids=<productB> will return receivables 3 and 5.

​
project_id__in
string<uuid>[]

Return only receivables whose project_id include at least one of the project_id with the specified IDs. Valid but nonexistent project IDs do not raise errors but produce no results.

​
type
enum<string>
Available options:
quote,
invoice,
credit_note
​
document_id
string
​
document_id__contains
string
​
document_id__icontains
string
​
issue_date__gt
string<date-time>
​
issue_date__lt
string<date-time>
​
issue_date__gte
string<date-time>
​
issue_date__lte
string<date-time>
​
created_at__gt
string<date-time>
​
created_at__lt
string<date-time>
​
created_at__gte
string<date-time>
​
created_at__lte
string<date-time>
​
counterpart_id
string<uuid>
​
counterpart_name
string
​
counterpart_name__contains
string
​
counterpart_name__icontains
string
​
amount
integer
​
amount__gt
integer
​
amount__lt
integer
​
amount__gte
integer
​
amount__lte
integer
​
status
enum<string>
Available options:
draft,
issuing,
issued,
failed,
accepted,
expired,
declined,
recurring,
partially_paid,
paid,
overdue,
uncollectible,
canceled
​
entity_user_id
string<uuid>
​
based_on
string<uuid>
​
due_date__gt
string<date>
​
due_date__lt
string<date>
​
due_date__gte
string<date>
​
due_date__lte
string<date>
​
has_due_date
boolean
​
project_id
string<uuid>

Response

Successful Response

A paginated list of receivables

​
data
object[]
required
​
next_pagination_token
string

A token that can be sent in the pagination_token query parameter to get the next page of results, or null if there is no next page (i.e. you've reached the last page).

​
prev_pagination_token
string

A token that can be sent in the pagination_token query parameter to get the previous page of results, or null if there is no previous page (i.e. you've reached the first page).