GET /v1/invoices/inbound

GET

/v1/invoices/inbound

curl --request GET \
  --url https://api.asap.cool/v1/invoices/inbound \
  --header 'Authorization: Bearer <token>'

• Production

Authorizations

• api_key
  invoice:read
• session

Parameters

Query Parameters

limit

integer | null format: int32

Page size, 1..=100 (defaults to 50).

cursor

string | null

Opaque cursor from a previous page’s meta.next_cursor.

Responses

200

Page of inbound invoices (newest first).

Media typeapplication/json

Array<object>

Public projection of an [InboundRecord].

Light by design: the structured CII XML and the integrity digest are not surfaced; the readable PDF is referenced by its object-store key.

object

byte_size

Size in bytes of the stored object, when known.

integer | null format: int64

created_at

required

RFC3339 creation timestamp.

string

currency

Invoice currency code (BT-5), when parsed.

string | null

due_date

Payment due date as ISO YYYY-MM-DD (BT-9), when parsed.

string | null

id

required

Stable identifier.

string format: uuid

imported_at

RFC3339 import timestamp, when set.

string | null

invoice_number

Invoice number extracted from the CII (BT-1), when parsed.

string | null

issue_date

Issue date as ISO YYYY-MM-DD (BT-2), when parsed.

string | null

parse_status

required

CII parse outcome: 'parsed', 'parse_failed', 'pdf_only' (a PDF with no embedded CII) or 'pending'.

string

pdf_origin

required

Origin of the PDF the /pdf route serves.

string

Allowed values: received rendered none

pdf_storage_key

Object-store key of the readable PDF, when stored.

string | null

received_at

RFC3339 reception timestamp (as reported by the PA), when known.

string | null

received_lifecycle

required

What the org decided about the invoice.

string

Allowed values: received approved refused disputed paid

refusal_reason

Motive of a refusal or dispute.

string | null

refusal_reason_code

Coded motive (MDT-113, AFNOR XP Z12-012) of a refusal or dispute; absent on decisions taken before the code was required.

string | null

seller_name

Seller name extracted from the CII (BT-27), when parsed.

string | null

sender_siren

SIREN of the sender, when provided.

string | null

submission_error

Failure code when submission_state is error: not_connected, rejected or enqueue_failed.

string | null

submission_state

required

Whether the decision has reached the platform.

string

Allowed values: none pending sent error

submitted_at

RFC3339 time the platform accepted the decision.

string | null

total_ht

Total amount without VAT in cents (BT-109), when parsed.

integer | null format: int64

total_ttc

Grand total with VAT in cents (BT-112), when parsed.

integer | null format: int64

total_vat

Total VAT amount in cents (BT-110), when parsed.

integer | null format: int64

transmission_id

required

PA-assigned transmission id.

string

Example

[
  {
    "pdf_origin": "received",
    "received_lifecycle": "received",
    "submission_state": "none"
  }
]

401

No active org.

Media typeapplication/json

Generic error body returned by API handlers when they fail. code is a stable machine-readable token; message is human-friendly and meant for surfacing to end users.

object

code

required

Stable machine token (e.g. invalid_credentials).

string

field

Offending request field for validation errors, when known.

string | null

message

required

Human-readable message.

string

Example ^generated

{
  "code": "example",
  "field": "example",
  "message": "example"
}

403

Missing invoice:read scope.

Media typeapplication/json

Generic error body returned by API handlers when they fail. code is a stable machine-readable token; message is human-friendly and meant for surfacing to end users.

object

code

required

Stable machine token (e.g. invalid_credentials).

string

field

Offending request field for validation errors, when known.

string | null

message

required

Human-readable message.

string

Example ^generated

{
  "code": "example",
  "field": "example",
  "message": "example"
}

422

Invalid limit or cursor.

Media typeapplication/json

Generic error body returned by API handlers when they fail. code is a stable machine-readable token; message is human-friendly and meant for surfacing to end users.

object

code

required

Stable machine token (e.g. invalid_credentials).

string

field

Offending request field for validation errors, when known.

string | null

message

required

Human-readable message.

string

Example ^generated

{
  "code": "example",
  "field": "example",
  "message": "example"
}