> ## Documentation Index > Fetch the complete documentation index at: https://docs.slash.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an invoice > Get an invoice. ## OpenAPI ````yaml /openapi-v2.json get /v2/invoices/{invoiceId} openapi: 3.1.0 info: title: Slash Public API V2 description: >- Send money for a Slash legal entity. Every request uses an API key. Transfer creation returns a Transfer that links its resulting transactions. version: 0.0.1 servers: - url: https://api.slash.com description: production security: - api_key: [] paths: /v2/invoices/{invoiceId}: parameters: - name: x-legal-entity in: header required: true description: >- The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to. schema: type: string pattern: ^le_[a-zA-Z0-9]+$ - name: invoiceId in: path required: true description: Invoice id with the `inv_` prefix. schema: type: string get: summary: Get an invoice description: Get an invoice. responses: '200': description: The invoice. content: application/json: schema: $ref: '#/components/schemas/invoice' '400': $ref: '#/components/responses/PublicApiV2Error400InvoicesGet' '401': $ref: '#/components/responses/PublicApiV2Error401Unauthorized' '403': $ref: >- #/components/responses/PublicApiV2Error403FeatureNotEnabledForbiddenLegalEntityNotAvailableUserApiKeyRequired '404': $ref: '#/components/responses/PublicApiV2Error404NotFound' '429': $ref: '#/components/responses/PublicApiV2RateLimited' '500': $ref: '#/components/responses/PublicApiV2Error500Internal' security: - api_key: [] components: schemas: invoice: title: Invoice description: >- A request for payment you send a customer. Slash emails it, hosts a payment page at `payUrl`, matches incoming deposits to it and keeps its `status` and `amounts` up to date. All amounts are in USD. type: object properties: id: type: string description: Invoice id with the `inv_` prefix. example: inv_2rj4l7hmrrrcv number: type: string description: Unique per legal entity. example: INV-1042 status: type: string enum: - scheduled - unpaid - partially_paid - paid - void description: >- See [Invoice lifecycle](/docs/v2/invoices/overview#invoice-lifecycle). overdue: type: boolean description: >- Whether the invoice is `unpaid` or `partially_paid` and its due date has passed in its `timezone`. customerId: type: string description: Customer id with the `le_cus_` prefix. example: le_cus_2rj4l7hmrrrcv accountId: type: string description: The account payments settle into, with the `sa_group_` prefix. example: sa_group_2rj4l7hmrrrcv virtualAccountId: type: string description: >- The virtual account payments settle into, with the `subaccount_` prefix. Absent when they settle into the account's primary virtual account. seriesId: type: string description: >- The recurring series that issued the invoice, with the `inv_series_` prefix. issueDate: type: string format: date dueDate: type: string format: date timezone: type: string description: The IANA timezone the invoice's dates are in. example: America/New_York scheduledSendDate: type: string format: date description: >- When a `scheduled` invoice will be emailed, at 9:00 in its `timezone`. lineItems: type: array items: $ref: '#/components/schemas/invoice-line-item' discount: $ref: '#/components/schemas/invoice-discount' taxRate: type: number description: >- Tax as a percent of the subtotal after the discount. `8.5` means 8.5%. example: 8.5 amounts: type: object properties: subtotal: allOf: - $ref: '#/components/schemas/Money' description: The line items' totals added up. discount: $ref: '#/components/schemas/Money' tax: $ref: '#/components/schemas/Money' total: allOf: - $ref: '#/components/schemas/Money' description: What the customer owes in all. paid: allOf: - $ref: '#/components/schemas/Money' description: What has been paid so far. outstanding: allOf: - $ref: '#/components/schemas/Money' description: What is still owed. Zero once the invoice is `paid` or `void`. required: - subtotal - discount - tax - total - paid - outstanding memo: type: string description: A note printed on the invoice. ccEmails: type: array description: Also copied on the invoice and its reminders. items: type: string billedTo: type: object description: The customer's details as they were when the invoice was created. properties: name: type: string email: type: string address: $ref: '#/components/schemas/address' required: - name - email paymentMethods: type: array items: $ref: '#/components/schemas/invoice-payment-method' payments: type: array description: Oldest first. items: $ref: '#/components/schemas/invoice-payment' payUrl: type: string description: The hosted page where the customer views and pays the invoice. documentId: type: string description: >- The invoice's PDF, with the `st_` prefix. Download it with `GET /v2/documents/{documentId}`. Each edit issues a new PDF. example: st_2rj4l7hmrrrcv nextReminderAt: type: string format: date-time description: When the next automatic reminder is due to go out. paidAt: type: string format: date-time description: When the invoice became `paid`. voidedAt: type: string format: date-time description: When the invoice was voided. createdAt: type: string format: date-time required: - id - number - status - overdue - accountId - issueDate - dueDate - timezone - lineItems - amounts - ccEmails - billedTo - paymentMethods - payments - payUrl - documentId - createdAt invoice-line-item: title: InvoiceLineItem type: object properties: name: type: string example: Robot arm maintenance quantity: type: number example: 2 unitAmount: $ref: '#/components/schemas/Money' total: allOf: - $ref: '#/components/schemas/Money' description: '`quantity` times `unitAmount`.' catalogItemId: type: string description: >- The catalog item the line was added from, with the `cat_item_` prefix. The line keeps the name and price it was written with. required: - name - quantity - unitAmount - total invoice-discount: title: InvoiceDiscount description: Taken off the line items' subtotal before tax. oneOf: - title: Percentage type: object properties: type: type: string enum: - percentage percent: type: number description: Percent of the subtotal. `10` means 10%. example: 10 required: - type - percent - title: Fixed type: object properties: type: type: string enum: - fixed amount: $ref: '#/components/schemas/Money' required: - type - amount Money: type: object description: A signed monetary amount expressed in minor units. properties: amount: type: integer description: Amount in the currency's minor units. currency: type: string pattern: ^[A-Z]{3}$ description: Uppercase ISO 4217 currency code. required: - amount - currency additionalProperties: false title: Money address: title: Address type: object properties: line1: type: string minLength: 1 line2: type: string city: type: string minLength: 1 state: type: string postalCode: type: string countryCode: type: string minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. required: - line1 - city additionalProperties: false invoice-payment-method: title: InvoicePaymentMethod description: A way the payer can pay on the invoice's payment page. type: object properties: type: type: string enum: - bank_transfer - ach_debit - card - crypto description: >- `bank_transfer` (ACH, wire or realtime payment to the account's details) is always offered. passFeeToPayer: type: boolean description: Whether the payer covers the method's processing fee. required: - type - passFeeToPayer invoice-payment: title: InvoicePayment description: >- Money recorded against an invoice: a deposit Slash matched to it, or a payment you recorded. type: object properties: id: type: string description: >- Payment id with the `inv_tr_link_` prefix. Remove it with `DELETE /v2/invoices/{invoiceId}/payments/{paymentId}`. example: inv_tr_link_2rj4l7hmrrrcv amount: $ref: '#/components/schemas/Money' paidOn: type: string format: date description: The day the payment arrived, in the invoice's `timezone`. method: type: string enum: - ach - wire - international_wire - realtime - ach_debit - card - crypto - other description: How the money arrived. transactionId: type: string description: >- The deposit, with the `agg_tx_` prefix, readable at `GET /v2/transactions/{transactionId}`. Absent for payments received outside Slash. example: agg_tx_2rj4l7hmrrrcv matchedBy: type: string enum: - automatic - manual description: >- `automatic` when Slash matched the deposit or the payer paid on the payment page; `manual` when it was recorded by hand. createdAt: type: string format: date-time description: When the payment was recorded. required: - id - amount - paidOn - method - matchedBy - createdAt PublicApiV2ErrorInvalidRequestShape: title: PublicApiV2ErrorInvalidRequestShape description: >- The body, query, or headers failed validation, or a required header is missing. `details` has one entry per failing location, keyed by JSON pointer or header name. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - invalid_request details: type: object properties: {} additionalProperties: type: string required: - code - details PublicApiV2ErrorUnauthorized: title: PublicApiV2ErrorUnauthorized description: API key authentication is missing or invalid. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - unauthorized details: type: object properties: {} additionalProperties: false required: - code - details PublicApiV2ErrorFeatureNotEnabled: title: PublicApiV2ErrorFeatureNotEnabled description: >- The feature this request uses is not enabled for the legal entity. Contact Slash support to enable it. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - feature_not_enabled details: type: object properties: {} additionalProperties: false required: - code - details PublicApiV2ErrorForbiddenLegalEntity: title: PublicApiV2ErrorForbiddenLegalEntity description: The credential is not permitted to act for the selected legal entity. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - forbidden details: type: object properties: {} additionalProperties: false required: - code - details PublicApiV2ErrorNotAvailable: title: PublicApiV2ErrorNotAvailable description: >- Public API v2 is not yet available. Use [Public API v1](https://docs.slash.com/introduction) in the meantime. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - not_available details: type: object properties: {} additionalProperties: false required: - code - details PublicApiV2ErrorUserApiKeyRequired: title: PublicApiV2ErrorUserApiKeyRequired description: >- The API key is scoped to a legal entity rather than a user. Every v2 request needs a user API key, created under Settings → API keys in the Slash dashboard, together with the `x-legal-entity` header. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - user_api_key_required details: type: object properties: {} additionalProperties: false required: - code - details PublicApiV2ErrorNotFound: title: PublicApiV2ErrorNotFound description: >- No resource matches the identifier. When the identifier is a field of the request, `details` names that `field` and the `id` it received. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - not_found details: type: object properties: field: type: string description: Dot path of the request field at fault. id: type: string description: The identifier that field carried, when it is one. additionalProperties: false required: - code - details PublicApiV2ErrorInternal: title: PublicApiV2ErrorInternal description: >- Slash could not complete the request. Quote `referenceId` when contacting Slash support. allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - internal details: type: object properties: {} additionalProperties: false required: - code - details Error: type: object properties: code: type: string description: >- Machine-readable reason; branch on this, not on `message`. Every code an endpoint can return is listed on its reference page; the ones shared by all endpoints are explained in the Errors guide. example: invalid_request message: type: string description: >- Human-readable explanation, safe to show to an operator. Wording may change; use `code` and `details` programmatically. details: type: object description: >- The values behind `message`, keyed per `code`. For example `insufficient_funds` carries `available` and `requested`; `invalid_request` from contract validation carries one entry per failing field, keyed by JSON pointer. Empty when the code has no variable data. additionalProperties: type: string example: available: $120.00 requested: $500.00 referenceId: type: string description: Unique id of this failure. Quote it when contacting Slash support. example: 4001-2alj5if required: - code - message - details - referenceId additionalProperties: false title: Error responses: PublicApiV2Error400InvoicesGet: description: >- - `invalid_request (request shape)` — The body, query, or headers failed validation, or a required header is missing. `details` has one entry per failing location, keyed by JSON pointer or header name. content: application/json: schema: $ref: '#/components/schemas/PublicApiV2ErrorInvalidRequestShape' examples: invalid_request_request_shape: summary: invalid_request (request shape) value: code: invalid_request message: >- Invalid `invoiceId`: Expected a valid ID beginning with "inv_". details: /invoiceId: Expected a valid ID beginning with "inv_". referenceId: 4001-2alj5if PublicApiV2Error401Unauthorized: description: '- `unauthorized` — API key authentication is missing or invalid.' content: application/json: schema: $ref: '#/components/schemas/PublicApiV2ErrorUnauthorized' examples: unauthorized: summary: unauthorized value: code: unauthorized message: API key authentication is missing or invalid. details: {} referenceId: 4011-2alj5if PublicApiV2Error403FeatureNotEnabledForbiddenLegalEntityNotAvailableUserApiKeyRequired: description: >- - `feature_not_enabled` — The feature this request uses is not enabled for the legal entity. Contact Slash support to enable it. - `forbidden (legal entity)` — The credential is not permitted to act for the selected legal entity. - `not_available` — Public API v2 is not yet available. Use [Public API v1](https://docs.slash.com/introduction) in the meantime. - `user_api_key_required` — The API key is scoped to a legal entity rather than a user. Every v2 request needs a user API key, created under Settings → API keys in the Slash dashboard, together with the `x-legal-entity` header. content: application/json: schema: anyOf: - title: feature_not_enabled allOf: - $ref: '#/components/schemas/PublicApiV2ErrorFeatureNotEnabled' - title: forbidden (legal entity) allOf: - $ref: '#/components/schemas/PublicApiV2ErrorForbiddenLegalEntity' - title: not_available allOf: - $ref: '#/components/schemas/PublicApiV2ErrorNotAvailable' - title: user_api_key_required allOf: - $ref: '#/components/schemas/PublicApiV2ErrorUserApiKeyRequired' examples: feature_not_enabled: summary: feature_not_enabled value: code: feature_not_enabled message: >- This feature is not enabled for you. Please contact support to get it. details: {} referenceId: 4031-2alj5if forbidden_legal_entity: summary: forbidden (legal entity) value: code: forbidden message: This credential is not permitted to do that. details: {} referenceId: 4031-2alj5if not_available: summary: not_available value: code: not_available message: >- Public API v2 is not yet available. Use Public API v1 (https://docs.slash.com/introduction) in the meantime. details: {} referenceId: 4031-2alj5if user_api_key_required: summary: user_api_key_required value: code: user_api_key_required message: >- Public API v2 requires a user API key. Create one under Settings → API keys in the Slash dashboard. details: {} referenceId: 4031-2alj5if PublicApiV2Error404NotFound: description: >- - `not_found` — No resource matches the identifier. When the identifier is a field of the request, `details` names that `field` and the `id` it received. content: application/json: schema: $ref: '#/components/schemas/PublicApiV2ErrorNotFound' examples: not_found: summary: not_found value: code: not_found message: The requested resource was not found. details: {} referenceId: 4041-2alj5if PublicApiV2RateLimited: description: >- The request exceeded the applicable rate limit. The response body is plain text, not the error object; clients must not depend on its wording. content: text/plain: schema: type: string example: You are rate limited PublicApiV2Error500Internal: description: >- - `internal` — Slash could not complete the request. Quote `referenceId` when contacting Slash support. content: application/json: schema: $ref: '#/components/schemas/PublicApiV2ErrorInternal' examples: internal: summary: internal value: code: internal message: >- An unexpected error occurred. If this keeps happening, contact Slash support with the reference id below. details: {} referenceId: 5001-2alj5if securitySchemes: api_key: type: apiKey name: X-API-Key in: header description: >- User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the `x-legal-entity` header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with `403 user_api_key_required`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.