> ## Documentation Index > Fetch the complete documentation index at: https://docs.horizonpay.co/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve the business profile > Returns your business profile — the issuer printed on every invoice: legal name, address, tax id, default currency, bank details and invoice prefix. Read-only over the API; edit it in Settings. **Scope:** `business:read` ## OpenAPI ````yaml /openapi.json get /business openapi: 3.1.0 info: title: Invoice-AI API version: 1.0.0 description: >- Stripe-shaped invoicing over HTTP: customers, products, prices, invoices and invoice items, with `cus_…`, `prod_…`, `price_…`, `in_…` and `ii_…` ids. - **Auth:** `Authorization: Bearer inv_live_…`, with per-key scopes. - **Envelope:** JSON bodies; responses wrap the resource in `{ "data": … }`; lists add `next_cursor`. - **Money:** integer minor units of the currency everywhere (`250000` is $2,500.00; ¥5,000 is `5000`). - **Errors:** RFC 9457 `application/problem+json` — branch on `code`. - **Idempotency:** operations that spend an invoice number, email or record payment require an `Idempotency-Key`. - **Rate limits:** 120 requests/minute per key. Sending email: 10/hour per key and 50/hour per account. See the `RateLimit-*` headers. contact: name: Invoice-AI support url: https://invoice.horizonpay.co servers: - url: https://invoice.horizonpay.co/api/v1 description: Production security: - apiKey: [] tags: - name: Business x-displayName: Business description: >- Your business profile — the issuer printed on every invoice. Read-only over the API; edit it in Settings. - name: Customers x-displayName: Customers description: >- The people and companies you bill. Every invoice references a customer by `cus_…` id. Customers are archived rather than deleted, so issued invoices keep naming who they were billed to. - name: Products x-displayName: Products description: >- The things you sell. A product carries a name and description; amounts live on its prices. Archiving sets `active: false` and keeps history intact. - name: Prices x-displayName: Prices description: >- Ways to charge for a product: an amount in integer minor units and a currency, one-time or recurring. Bill a price on an invoice line with `price: "price_…"`. - name: Invoices x-displayName: Invoices description: >- Invoices move `draft` → `open` (finalize assigns a permanent, consecutive number) → `paid`, or `open` → `void`. Drafts are freely editable and deletable; finalized invoices are frozen. `overdue` is an open invoice past its due date, derived at read time. Operations that spend a number, send email or record payment require an `Idempotency-Key`. - name: Invoice items x-displayName: Invoice items description: >- Individual lines of an invoice. Add or remove lines on a draft one at a time; totals are recomputed server-side and the whole invoice is returned. - name: Webhook endpoints x-displayName: Webhook endpoints description: >- Register https endpoints to receive invoice events (`invoice.created`, `invoice.finalized`, `invoice.paid`, …). Deliveries are signed per [Standard Webhooks](https://www.standardwebhooks.com/) with `webhook-id`, `webhook-timestamp` and `webhook-signature` headers (HMAC-SHA256 over `{id}.{timestamp}.{body}`); failed deliveries are retried with backoff. paths: /business: get: tags: - Business summary: Retrieve the business profile description: >- Returns your business profile — the issuer printed on every invoice: legal name, address, tax id, default currency, bank details and invoice prefix. Read-only over the API; edit it in Settings. **Scope:** `business:read` operationId: getBusiness responses: '200': description: The business profile. headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: example: data: id: 0c6f2d8e-3a41-4b9e-8f17-5d2a9c4e1b73 legal_name: Horizon Consulting LLC trade_name: Horizon country_code: US currency: USD tax_id: US-EIN 98-7654321 address: line1: 500 Congress Ave line2: Suite 1200 city: Austin region: TX postal_code: '78701' country_code: US country: United States email: billing@horizon.example phone: +1 512 555 0199 bank: bank_name: First Austin Bank account_name: Horizon Consulting LLC account_number: '000123456789' routing_number: '111000025' invoice_prefix: INV created_at: '2026-01-05T12:00:00.000Z' schema: type: object properties: data: $ref: '#/components/schemas/Business' description: The business profile. required: - data additionalProperties: false '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: >- No business profile yet — onboarding is unfinished. Another account's resource is also a `404`, so ids cannot be probed. Codes: `not_found`. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: not_found: summary: No business profile yet. Finish onboarding first. value: type: https://invoice.horizonpay.co/problems/not-found title: Not found status: 404 detail: No business profile yet. Finish onboarding first. instance: req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 code: not_found '429': $ref: '#/components/responses/RateLimited' x-codeSamples: - lang: bash label: cURL source: |- curl https://invoice.horizonpay.co/api/v1/business \ -H "Authorization: Bearer $INVOICE_AI_API_KEY" - lang: node label: Node.js source: |- import InvoiceAI from '@horizonpay/invoice-ai' const invoiceai = new InvoiceAI() // reads INVOICE_AI_API_KEY const business = await invoiceai.business.retrieve() console.log(business.legal_name, business.currency) - lang: python label: Python source: |- from invoice_ai import InvoiceAI client = InvoiceAI() # reads INVOICE_AI_API_KEY business = client.business.retrieve() print(business.legal_name, business.currency) components: headers: RequestId: required: true description: >- The request id: yours, if you sent `X-Request-Id` (up to 200 characters), otherwise one we generated. Quote it to support. schema: type: string description: >- The request id: yours, if you sent `X-Request-Id` (up to 200 characters), otherwise one we generated. Quote it to support. examples: - req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 RateLimitLimit: required: true description: Requests allowed in the current window for this key and bucket. schema: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Requests allowed in the current window for this key and bucket. examples: - 120 RateLimitRemaining: required: true description: Requests left in the current window. schema: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Requests left in the current window. examples: - 119 RateLimitReset: required: true description: Unix time (seconds) at which the window resets. schema: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Unix time (seconds) at which the window resets. examples: - 1789371294 RetryAfter: required: true description: Seconds to wait before retrying. schema: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Seconds to wait before retrying. examples: - 42 schemas: Business: type: object properties: id: type: string description: Business id (UUID). examples: - 0c6f2d8e-3a41-4b9e-8f17-5d2a9c4e1b73 legal_name: type: string description: Registered legal name, printed as the invoice issuer. examples: - Horizon Consulting LLC trade_name: anyOf: - type: string - type: 'null' description: Trading name, if different. examples: - Horizon country_code: type: string description: ISO 3166-1 alpha-2 country code. examples: - US currency: type: string description: Default invoice currency (ISO 4217). examples: - USD tax_id: anyOf: - type: string - type: 'null' description: Your tax registration number, free text. examples: - US-EIN 98-7654321 address: type: object properties: line1: anyOf: - type: string - type: 'null' description: Street address. examples: - 500 Congress Ave line2: anyOf: - type: string - type: 'null' description: Suite, floor, unit. city: anyOf: - type: string - type: 'null' description: City. examples: - Austin region: anyOf: - type: string - type: 'null' description: State, province or region. examples: - TX postal_code: anyOf: - type: string - type: 'null' description: ZIP or postal code. examples: - '78701' country_code: anyOf: - type: string - type: 'null' description: ISO 3166-1 alpha-2 country code. examples: - US country: anyOf: - type: string - type: 'null' description: Country name. examples: - United States required: - line1 - line2 - city - region - postal_code - country_code - country additionalProperties: false description: Registered address. email: anyOf: - type: string - type: 'null' description: Contact email printed on invoices. examples: - billing@horizon.example phone: anyOf: - type: string - type: 'null' description: Contact phone. examples: - +1 512 555 0199 bank: type: object properties: bank_name: anyOf: - type: string - type: 'null' description: Bank name. examples: - First Austin Bank account_name: anyOf: - type: string - type: 'null' description: Account holder name. examples: - Horizon Consulting LLC account_number: anyOf: - type: string - type: 'null' description: Account number (or IBAN). examples: - '000123456789' routing_number: anyOf: - type: string - type: 'null' description: Routing number, sort code, IFSC or SWIFT. examples: - '111000025' required: - bank_name - account_name - account_number - routing_number additionalProperties: false description: Payment details printed on invoices. invoice_prefix: type: string description: Prefix of every invoice number, e.g. `INV` in `INV-0042`. examples: - INV created_at: type: string description: When the business profile was created (ISO 8601). format: date-time required: - id - legal_name - trade_name - country_code - currency - tax_id - address - email - phone - bank - invoice_prefix - created_at additionalProperties: false description: Your business profile — the "From" side of every invoice. Problem: type: object properties: type: type: string description: >- A URI identifying the problem type: `https://invoice.horizonpay.co/problems/` with underscores as hyphens. examples: - https://invoice.horizonpay.co/problems/invalid-state title: type: string description: Short, human-readable summary of the problem type. examples: - Invalid state for this operation status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The HTTP status code, repeated for convenience. examples: - 409 detail: type: string description: >- Human-readable explanation of this occurrence. Wording may change — do not parse it. examples: - This invoice has been finalized and can no longer be edited. instance: type: string description: >- The request id (also sent as `X-Request-Id`), for correlating with our logs. examples: - req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 code: type: string description: >- Stable machine-readable code. Branch on this, never on `detail`. One of: `validation`, `idempotency_mismatch`, `unauthorized`, `forbidden`, `not_found`, `invalid_state`, `conflict`, `idempotency_key_required`, `rate_limited`, `upstream_failed`, `internal_error`. examples: - invalid_state errors: description: Field-level problems. Present on `validation` errors only. type: array items: type: object properties: path: type: string description: Dot-path of the offending field, e.g. `items.0.unit_amount`. examples: - email message: type: string description: What is wrong with it. examples: - Enter a valid email required: - path - message additionalProperties: false required: - type - title - status - detail - instance - code additionalProperties: false description: >- An RFC 9457 problem details object, served as `application/problem+json`. Every non-2xx response uses this shape. responses: Unauthorized: description: >- The API key is missing, malformed, unknown, revoked or expired. The response carries `WWW-Authenticate: Bearer`. Codes: `unauthorized`. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: unauthorized: summary: 'Send your API key as `Authorization: Bearer inv_live_…`.' value: type: https://invoice.horizonpay.co/problems/unauthorized title: Unauthorized status: 401 detail: 'Send your API key as `Authorization: Bearer inv_live_…`.' instance: req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 code: unauthorized Forbidden: description: >- The key is valid but lacks a scope this operation needs (see `x-required-scope`). Codes: `forbidden`. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: forbidden: summary: This credential is missing the invoices:write scope. value: type: https://invoice.horizonpay.co/problems/forbidden title: Insufficient scope status: 403 detail: This credential is missing the invoices:write scope. instance: req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 code: forbidden RateLimited: description: >- Rate limit exceeded for this API key. Wait the number of seconds in `Retry-After` before retrying. Codes: `rate_limited`. headers: Retry-After: $ref: '#/components/headers/RetryAfter' X-Request-Id: $ref: '#/components/headers/RequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: rate_limited: summary: Rate limit of 120 per 60s exceeded. value: type: https://invoice.horizonpay.co/problems/rate-limited title: Too many requests status: 429 detail: Rate limit of 120 per 60s exceeded. instance: req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71 code: rate_limited securitySchemes: apiKey: type: http scheme: bearer bearerFormat: inv_live__ description: >- An Invoice-AI API key sent as `Authorization: Bearer inv_live_…`. Create keys in **Settings → API keys**; the secret is shown once. Each key carries scopes, and every operation lists the scope it needs (`x-required-scope`): - `business:read` — Read your business profile, tax ID and bank details - `clients:read` — List and read your clients - `clients:write` — Create, update and archive clients - `products:read` — List and read products and prices - `products:write` — Create, update and archive products and prices - `invoices:read` — List and read invoices, including PDFs - `invoices:write` — Create, edit and delete drafts - `invoices:finalize` — Finalize invoices and void them - `invoices:send` — Email invoices to your clients - `payments:write` — Mark invoices as paid - `webhooks:manage` — Manage webhook endpoints Keys cannot be created or revoked through the API, so a leaked key cannot mint more keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.