Commercial Invoices

Endpoints relating to Commercial Invoice objects

List commercial invoices

Returns a list of commercial invoices

Request
query Parameters
page
integer >= 1
Default: 1

Page number of the page to retrieve

Example: page=1
per
integer [ 1 .. 100 ]
Default: 20

Count of items in each page. Should be between 1 and 100 (inclusive)

Example: per=20
f.shipment.id
string

The unique id for the shipment.

f.invoice_number
string

Filters results based on the invoice number.

f.involved_party_seller_id
string

Filters results based on the involved party seller ID.

f.involved_party_seller_ref
string

Filters results based on the involved party seller ref.

f.updated_at
string

Filters results with the specified updated_at

f.created_at.gt
string

Filters results updated after the specified date

f.created_at.gte
string

Filters results updated after the specified date, inclusive

f.created_at.lt
string

Filters results updated before the specified date

f.created_at.lte
string

Filters results updated before the specified date, inclusive

Responses
200

Success

Response Schema: application/json
_object
string
self
string
version
integer
object
_object
string
prev
string or null
next
string or null
Array of objects (CommercialInvoice)
get/commercial_invoices
Response samples
application/json

Success

{
  • "_object": "/api/response",
  • "self": "https://api.flexport.com/commercial_invoices?page=2&per=10",
  • "version": 2,
  • "data": {
    • "_object": "/api/collections/paginated",
    • "prev": "https://api.flexport.com/commercial_invoices?page=1&per=10",
    • "next": null,
    • "data": [
      • {
        }
      ]
    }
}

Retrieve a commercial invoice

Retrieves the details of a single commercial invoice.

Request
path Parameters
id
required
string

The unique id for the requested commercial invoice

Responses
200

Success

Response Schema: application/json
_object
string
self
string
version
integer
object (CommercialInvoice)
_object
string

Type of the object. Always /commercial_invoice for this object.

id
string

Unique identifier for the commercial invoice.

invoice_number
string

Invoice number on the commercial invoice, typically used for display purposes.

digitization_status
string or null

Status about if the digitization process for this commercial invoice is complete. If it is not complete, then the commercial invoice should be considered a draft that can change.

Enum: "pending" "reviewed" "complete"
Array of objects (CommercialInvoiceLineItem)
Array of objects (CustomsInvolvedParty)
is_related_parties
boolean

Whether there was a related parties transaction as defined by CBP.

Array of objects (Address)
metadata
object (Metadata)

Set of custom key-values specific to the object. The keys are strings and values are arrays of strings. The set of valid keys is always the consignee's list of keys, even if call was made by a different party.

object (ShipmentRef)
total_unit_count
string

Total units on this commercial invoice.

object (Money)
object (Volume)
object (Weight)
order_number
string

Represents the which order the invoice is linked to. This can be null.

currency
string
invoice_date
string

Represents date of the invoice. This can be null.

updated_at
string or null <date-time>

Represents the last time the invoice was updated. This can be null.

400

error

get/commercial_invoices/{id}
Response samples
application/json

Success

{
  • "_object": "/api/response",
  • "self": "https://api.flexport.com/commercial_invoices/abcxyz-23456-def",
  • "version": 2,
  • "data": {
    • "_object": "/commercial_invoice",
    • "id": "abcxyz-23456-def",
    • "invoice_number": "ABCDEFGHIJKLMNOP",
    • "digitization_status": "complete",
    • "manufacturer_addresses": [
      • {
        }
      ],
    • "total_value": {
      • "_object": "/money",
      • "amount": "100",
      • "currency_code": "USD"
      },
    • "total_unit_count": "12345",
    • "total_weight": {
      • "_object": "/quantity/weight",
      • "value": 100,
      • "unit": "kg"
      },
    • "total_volume": {
      • "_object": "/quantity/volume",
      • "value": 100,
      • "unit": "cbm"
      },
    • "line_items": [
      • {
        }
      ],
    • "shipment": {}
    }
}
➔ Next to Customs Entries