Get Member Invoices

List invoices for a specific member

GET https://app.usatimbre.com/api/timbre/member-invoices

cURL

curl -X GET "https://app.usatimbre.com/api/timbre/member-invoices?org_id=org_123456&rfc=XAXX010101000&limit=10&offset=0" \
  -H "Authorization: Bearer tmb_your_api_key_here"

200

{
  "invoices": [
    {
      "id": "inv_abc123",
      "status": "completed",
      "amount": 1500.00,
      "currency": "MXN",
      "vendor": "Restaurant XYZ",
      "created_at": "2024-01-20T15:30:00Z",
      "pdf_url": "https://app.usatimbre.com/invoices/inv_abc123.pdf",
      "xml_url": "https://app.usatimbre.com/invoices/inv_abc123.xml"
    },
    {
      "id": "inv_def456",
      "status": "completed",
      "amount": 850.50,
      "currency": "MXN",
      "vendor": "Office Supplies Co",
      "created_at": "2024-01-18T10:00:00Z",
      "pdf_url": "https://app.usatimbre.com/invoices/inv_def456.pdf",
      "xml_url": "https://app.usatimbre.com/invoices/inv_def456.xml"
    }
  ],
  "total": 25,
  "limit": 10,
  "offset": 0
}

Overview

Retrieve a paginated list of invoices for a specific member.

Query Parameters

org_id · string · required

The unique identifier of the organization

rfc · string · required

The RFC (Mexican tax ID) of the member

limit · number · default: "10"

Maximum number of invoices to return. Default: 10

offset · number · default: "0"

Number of invoices to skip for pagination. Default: 0

Response

invoices · array

Array of invoice objects

Show Invoice object properties

id · string

Unique invoice identifier

status · string

Invoice status (e.g., completed, pending, failed)

amount · number

Invoice total amount

currency · string

Currency code (e.g., MXN)

vendor · string

Vendor/merchant name

created_at · string

ISO 8601 timestamp of creation

pdf_url · string

URL to download the invoice PDF

xml_url · string

URL to download the invoice XML (CFDI)

total · number

Total number of invoices for this member

limit · number

Limit used in the query

offset · number

Offset used in the query

cURL

curl -X GET "https://app.usatimbre.com/api/timbre/member-invoices?org_id=org_123456&rfc=XAXX010101000&limit=10&offset=0" \
  -H "Authorization: Bearer tmb_your_api_key_here"

200

{
  "invoices": [
    {
      "id": "inv_abc123",
      "status": "completed",
      "amount": 1500.00,
      "currency": "MXN",
      "vendor": "Restaurant XYZ",
      "created_at": "2024-01-20T15:30:00Z",
      "pdf_url": "https://app.usatimbre.com/invoices/inv_abc123.pdf",
      "xml_url": "https://app.usatimbre.com/invoices/inv_abc123.xml"
    },
    {
      "id": "inv_def456",
      "status": "completed",
      "amount": 850.50,
      "currency": "MXN",
      "vendor": "Office Supplies Co",
      "created_at": "2024-01-18T10:00:00Z",
      "pdf_url": "https://app.usatimbre.com/invoices/inv_def456.pdf",
      "xml_url": "https://app.usatimbre.com/invoices/inv_def456.xml"
    }
  ],
  "total": 25,
  "limit": 10,
  "offset": 0
}