Skip to main content
GET
/
v1
/
fiscal_profiles
Error
A valid request URL is required to generate request examples
{
  "object": "list",
  "url": "https://example.com/webhooks/invoice",
  "data": [
    {
      "object": "fiscal_profile",
      "id": "obj_2P9K3sample",
      "rfc": "XAXX010101000",
      "legal_name": "string",
      "tax_regime": "string",
      "zip": "string",
      "csd": {
        "serial": "string",
        "valid_from": "string",
        "valid_to": "string",
        "rfc": "XAXX010101000"
      },
      "status": "requires_action",
      "has_fiel": true,
      "manifest_status": "pending_signature",
      "manifest_signed_at": "2026-07-10T18:25:43Z",
      "next_actions": [
        {
          "type": "string",
          "message": "string",
          "endpoint": "string",
          "requires": [
            "string"
          ]
        }
      ],
      "pending_actions": [
        {
          "type": "string",
          "message": "string",
          "endpoint": "string",
          "requires": [
            "string"
          ]
        }
      ],
      "metadata": {},
      "brand_color": "string",
      "has_logo": true,
      "livemode": false,
      "created_at": "2026-07-10T18:25:43Z",
      "updated_at": "2026-07-10T18:25:43Z"
    }
  ],
  "has_more": true
}
{
  "type": "https://errors.invoiceapi.mx/auth_unauthorized",
  "title": "Authentication required",
  "status": 401,
  "code": "auth.unauthorized",
  "detail": "Missing or invalid API key.",
  "remediation": "Send `Authorization: Bearer sk_test_...` (or sk_live_...) with a valid API key.",
  "doc_url": "/docs/errors#auth-unauthorized",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/fiscal_profile_invalid_csd",
  "title": "Invalid CSD certificate or password",
  "status": 422,
  "code": "fiscal_profile.invalid_csd",
  "detail": "The CSD .cer/.key pair could not be opened.",
  "remediation": "Verify cer_base64 is the .cer, key_base64 is the .key, and the password.",
  "doc_url": "/docs/errors#fiscal_profile-invalid_csd",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit.exceeded",
  "detail": "Too many requests for this key + request class (reads and writes are limited separately).",
  "remediation": "Back off and retry after the number of seconds in the Retry-After header; batch work or lower your request rate.",
  "doc_url": "/docs/errors#rate_limit-exceeded",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/internal_error",
  "title": "Internal server error",
  "status": 500,
  "code": "internal.error",
  "detail": "An unexpected error occurred.",
  "remediation": "Retry later; contact support with the request_id if it persists.",
  "doc_url": "/docs/errors#internal-error",
  "request_id": "req_2P9K3sample"
}

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer sk_test_... or sk_live_....

Headers

​
Invoice-Version
string

Pin a dated API release (Stripe-style). Omit to use the current version. An unknown value returns 400 request.invalid_version. Echoed back on every response.

Example:

"2026-07-10"

​
Invoice-Account
string

Connect: act on behalf of one of your connected accounts (its acct_…/org_… id). Omit to act as your own organization. Not honored on /v1/api_keys.

Example:

"org_2P9connectedacct"

Query Parameters

​
limit
integer
default:20

Page size, 1-100 (default 20).

Required range: 1 <= x <= 100
​
starting_after
string

Cursor: return the page of profiles older than this id.

Minimum string length: 1
​
ending_before
string

Cursor: return the page of profiles newer than this id.

Minimum string length: 1

Response

Default Response

​
object
enum<string>
required

Always "list".

Available options:
list
​
data
object[]
required

The page of fiscal profiles, newest first.

​
has_more
boolean
required

True if more results exist beyond this page.

​
url
string

The path this list was requested from, e.g. "/v1/fiscal_profiles".