> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usatimbre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Member Invoices

> List invoices for a specific member

## Overview

Retrieve a paginated list of invoices for a specific member.

## Query Parameters

<ParamField query="org_id" type="string" required>
  The unique identifier of the organization
</ParamField>

<ParamField query="rfc" type="string" required>
  The RFC (Mexican tax ID) of the member
</ParamField>

<ParamField query="limit" type="number" default="10">
  Maximum number of invoices to return. Default: 10
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of invoices to skip for pagination. Default: 0
</ParamField>

## Response

<ResponseField name="invoices" type="array">
  Array of invoice objects

  <Expandable title="Invoice object properties">
    <ResponseField name="id" type="string">
      Unique invoice identifier
    </ResponseField>

    <ResponseField name="status" type="string">
      Invoice status (e.g., `completed`, `pending`, `failed`)
    </ResponseField>

    <ResponseField name="amount" type="number">
      Invoice total amount
    </ResponseField>

    <ResponseField name="currency" type="string">
      Currency code (e.g., `MXN`)
    </ResponseField>

    <ResponseField name="vendor" type="string">
      Vendor/merchant name
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>

    <ResponseField name="pdf_url" type="string">
      URL to download the invoice PDF
    </ResponseField>

    <ResponseField name="xml_url" type="string">
      URL to download the invoice XML (CFDI)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total number of invoices for this member
</ResponseField>

<ResponseField name="limit" type="number">
  Limit used in the query
</ResponseField>

<ResponseField name="offset" type="number">
  Offset used in the query
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    org_id: 'org_123456',
    rfc: 'XAXX010101000',
    limit: '10',
    offset: '0'
  });
  const response = await fetch(`https://app.usatimbre.com/api/timbre/member-invoices?${params}`, {
    headers: {
      'Authorization': 'Bearer tmb_your_api_key_here'
    }
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.usatimbre.com/api/timbre/member-invoices',
      params={
          'org_id': 'org_123456',
          'rfc': 'XAXX010101000',
          'limit': 10,
          'offset': 0
      },
      headers={'Authorization': 'Bearer tmb_your_api_key_here'}
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Not Found",
    "message": "Member not found"
  }
  ```
</ResponseExample>