# Finance Domain API

API Gateway routing contract for the Finance domain. Routes requests to downstream invoice service via VPC link. The full domain contract including schemas, examples, and error definitions is in invoices-openapi.yaml.


Version: 0.0.1

## Security

### jwt-authorizer

Type: oauth2

## Download OpenAPI description

[Finance Domain API](https://test.docs.reece.tech/_bundle/apis/finance/openapi/@current/openapi.yaml)

## Other

### Retrieve one or more invoices

 - [GET /v1/{countryCode}/invoices](https://test.docs.reece.tech/apis/finance/openapi/openapi-1/other/getinvoices.md): Returns invoice data for one or more invoice numbers. Repeat the invoiceNumber query parameter for batch retrieval (max 50 per request). All requested invoices must be valid and eligible — if any single invoice is not found or not eligible, the entire request fails.

### Retrieve a single invoice by invoice number

 - [GET /v1/{countryCode}/invoices/{invoiceNumber}](https://test.docs.reece.tech/apis/finance/openapi/openapi-1/other/getinvoice.md): Returns complete invoice details including headers, line items, payments, and totals for a specific invoice number.