Invoice List Api - Justpaid Docs

GET

api

invoice

curl --request GET \
  --url https://api.justpaid.io/api/v1/invoice/ \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "invoice_status": "draft",
      "amount": 1000,
      "currency": "USD",
      "invoice_number": "INV-2024-001",
      "invoice_date": "2024-03-21",
      "line_items": [
        {
          "name": "Product A",
          "unit_price": 100,
          "quantity": 2,
          "amount": 200,
          "currency": "USD"
        }
      ],
      "customer": {
        "uuid": "456e4567-e89b-12d3-a456-426614174000",
        "name": "Customer Name"
      }
    }
  ],
  "count": 1
}

Authorizations

Authorization

string

header

required

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

Query Parameters

invoice_status

string

Filter by invoice status (e.g., 'draft', 'sent', 'paid')

customer

string

Filter by customer UUID

limit

integer

Number of results to return per page

offset

integer

Number of results to skip

Response

200 - application/json

List of invoices retrieved successfully

items

object[]

required

items.uuid

string

The unique identifier for the invoice

Example:

"123e4567-e89b-12d3-a456-426614174000"

items.invoice_status

string

The current status of the invoice

Example:

"draft"

items.amount

number

The total amount due for the invoice

Example:

1000

items.currency

string

The currency code for the invoice

Example:

"USD"

items.invoice_number

string

The unique invoice number

Example:

"INV-2024-001"

items.invoice_date

string

The date when the invoice was created

Example:

"2024-03-21"

items.due_date

string | null

The date by which the invoice must be paid

Example:

"2024-04-21"

items.service_start_date

string | null

The start date of the service period

Example:

"2024-03-01"

items.service_end_date

string | null

The end date of the service period

Example:

"2024-03-31"

items.description

string | null

A description of the invoice

Example:

"Monthly services for March 2024"

items.created_at

string

The timestamp when the invoice was created

Example:

"2024-03-21T10:00:00Z"

items.is_recurring

boolean

Indicates if this is a recurring invoice

Example:

false

items.from_external_source

boolean

Indicates if the invoice was created from an external source

Example:

false

items.external_source

string | null

The name of the external source if applicable

Example:

"stripe"

items.external_source_id

string | null

The ID of the invoice in the external system

Example:

"inv_123456"

items.payment_link

string | null

URL where the customer can pay this invoice

Example:

"https://app.justpaid.ai/portal/inv/123"

items.line_items

object[]

List of line items included in this invoice

items.file_url

string | null

URL to download the invoice PDF

Example:

"https://api.justpaid.ai/invoices/123.pdf"

items.customer

object | null

Details of the customer associated with this invoice

count

integer

required

Invoice Get Api Invoice Payment Create Api

curl --request GET \
  --url https://api.justpaid.io/api/v1/invoice/ \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "invoice_status": "draft",
      "amount": 1000,
      "currency": "USD",
      "invoice_number": "INV-2024-001",
      "invoice_date": "2024-03-21",
      "line_items": [
        {
          "name": "Product A",
          "unit_price": 100,
          "quantity": 2,
          "amount": 200,
          "currency": "USD"
        }
      ],
      "customer": {
        "uuid": "456e4567-e89b-12d3-a456-426614174000",
        "name": "Customer Name"
      }
    }
  ],
  "count": 1
}

API Documentation

Authorizations

Query Parameters

Response