Invoices
Invoices
Invoice management operations.
Create, retrieve, and list invoices with flexible querying.
Invoices are issued by Entities to Customers and contain line items with optional taxes.
The Invoice object
Attributes
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_6595a27b5d35015c3ef0c402",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "DOC-2025-001",
"date": "2025-03-15T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"address": "1 Launchpad Way",
"city": "Cape Canaveral",
"state": "FL",
"post_code": "32920",
"country": "USA",
"country_code": "US",
"tax_number": "59-8765432"
},
"customer_id": "cus_6595a27b5d35015c3ef0c403",
"customer": {
"name": "Horizon Launch Systems Inc.",
"address": "100 Rocket Row",
"city": "Houston",
"state": "TX",
"post_code": "77058",
"country": "USA",
"country_code": "US",
"tax_number": "74-1234567"
},
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c402",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Ground Station Antenna Array",
"description": "Deep space tracking antenna with 12m dish",
"quantity": 2,
"price": 12500,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 25000,
"total_with_tax": 30500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"project_code": "MSN-2025-001",
"department": "Ground Operations"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
},
{
"id": "inv_item_6595a27b5d35015c3ef0c403",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Orbital Navigation License",
"description": "Annual software license for orbital trajectory planning",
"quantity": 1,
"price": 5000,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 5000,
"total_with_tax": 6100,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"license_type": "enterprise",
"seats": "50"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
}
],
"note": "Thank you for your order. Equipment ships within 5 business days.",
"reference": "PO-2025-001",
"total": 30000,
"total_with_tax": 36600,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"base": 30000,
"rate": 22,
"amount": 6600,
"reverse_charge": false,
"tax_id": null
}
],
"date_year": 2025,
"metadata": {
"project_id": "MSN-2025-001",
"contract_id": "ORB-2024-789"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2025-04-15T00:00:00.000Z",
"total_paid": 0,
"total_due": 36600,
"paid_in_full": false,
"furs": null,
"fina": null
}Create a new invoice
/invoicesCreate a new invoice with line items.
Customer is optional - can be omitted for retail/convenience store sales where customer information isn't needed, or added inline without referencing a customer_id.
The invoice number is auto-generated based on the entity's number format settings.
Taxes are calculated automatically based on the tax rates provided.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Body parameters
Document date in YYYY-MM-DD format
Document due date in YYYY-MM-DD format
Service date in YYYY-MM-DD format. For invoices and credit notes.
Referenced Customer ID. Required if customer is not provided.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
curl -X POST "https://eu.spaceinvoices.com/invoices" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"name": "Satellite Communication Module",
"quantity": 1,
"price": 1500
}
]
}'Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_6595a27b5d35015c3ef0c3fd",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "2026-00001",
"date": "2026-01-01T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"country": "United States",
"country_code": "US"
},
"customer_id": null,
"customer": null,
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c3fd",
"invoice_id": "inv_6595a27b5d35015c3ef0c3fd",
"advance_invoice_id": null,
"item_id": null,
"name": "Satellite Communication Module",
"description": null,
"quantity": 1,
"price": 1500,
"gross_price": null,
"taxes": [],
"discounts": [],
"type": null,
"unit": null,
"total": 1500,
"total_with_tax": 1500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"note": null,
"reference": null,
"total": 1500,
"total_with_tax": 1500,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"rate": null,
"tax_id": null,
"base": 1500,
"amount": 0,
"reverse_charge": false
}
],
"date_year": 2026,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2026-02-01T00:00:00.000Z",
"total_paid": 0,
"total_due": 1500,
"paid_in_full": false,
"furs": null,
"fina": null
}Create invoice with pre-calculated totals
/invoices/customCreate an invoice with pre-calculated totals from an external ERP or accounting system.
The caller provides total, total_with_tax, and taxes at the document level, and total/total_with_tax on each line item.
All other logic (numbering, fiscalization, customer handling, payments, lifecycle hooks) is identical to the standard create endpoint.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Body parameters
Referenced Customer ID.
Pre-calculated document total (before tax).
Pre-calculated document total (after tax).
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
curl -X POST "https://eu.spaceinvoices.com/invoices/custom" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"total": 1500,
"total_with_tax": 1830,
"taxes": [
{
"rate": 22,
"base": 1500,
"amount": 330
}
],
"items": [
{
"name": "Imported Service",
"quantity": 1,
"price": 1500,
"total": 1500,
"total_with_tax": 1830,
"taxes": [
{
"rate": 22
}
]
}
]
}'Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_6595a27b5d35015c3ef0c3fd",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "2026-00001",
"date": "2026-01-01T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"country": "United States",
"country_code": "US"
},
"customer_id": null,
"customer": null,
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c3fd",
"invoice_id": "inv_6595a27b5d35015c3ef0c3fd",
"advance_invoice_id": null,
"item_id": null,
"name": "Satellite Communication Module",
"description": null,
"quantity": 1,
"price": 1500,
"gross_price": null,
"taxes": [],
"discounts": [],
"type": null,
"unit": null,
"total": 1500,
"total_with_tax": 1500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"note": null,
"reference": null,
"total": 1500,
"total_with_tax": 1500,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"rate": null,
"tax_id": null,
"base": 1500,
"amount": 0,
"reverse_charge": false
}
],
"date_year": 2026,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2026-02-01T00:00:00.000Z",
"total_paid": 0,
"total_due": 1500,
"paid_in_full": false,
"furs": null,
"fina": null
}List all invoices
/invoicesRetrieve a paginated list of invoices with optional filtering and sorting.
Supports cursor-based pagination, flexible JSON querying with MongoDB-style operators, full-text search, and sorting.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Query parameters
Number of results per request.
Default: 10
Opaque cursor to fetch the next page of results. Reuse only with the same effective ordering. Use the value from pagination.next_cursor in the previous response.
Opaque cursor to fetch the previous page of results. Reuse only with the same effective ordering. Use the value from pagination.prev_cursor in the previous response.
Whether to include the total count of items in pagination.total.
Default is true.
When false, pagination.total returns -1 for better performance.
Sort by one field or provide a repeated array for multi-column ordering. Prefix a field with - for descending order. When paginating, reuse cursors only with the same effective ordering.
JSON query object for filtering results. Supports MongoDB-style operators.
Supported operators:
- equals or direct value - Exact match (default)
- gte - Greater than or equal
- lte - Less than or equal
- gt - Greater than
- lt - Less than
- in - Value in array
- notIn - Value not in array
- contains - String contains (case-insensitive)
- startsWith - String starts with
- endsWith - String ends with
- between - Value between two numbers/dates [min, max]
Allowed fields: id, number, date, customer, customer.name, customer.email, customer.address, customer.city, customer.country, total, total_with_tax, items.name, items.description, payments.type, payments.date, document_relations.relation_type, document_relations.target_type, metadata, created_at, updated_at, paid_in_full, voided_at, date_due, paid_in_full, total_due, total_paid, voided_at
Examples:
- {"total": {"gte": 1000}} - Invoices over 1000
- {"customer.name": {"contains": "Acme"}} - Customer name contains "Acme"
- {"date": {"between": ["2025-01-01", "2025-12-31"]}} - Date range
Full-text search query to filter results across multiple fields.
Searches are case-insensitive and match partial strings.
Searches across all text fields including names, descriptions, addresses, and metadata values.
Comma-separated list of relations to include in the response.
Available relations:
- payments - Payment records linked to this invoice
- document_relations - Linked documents (credit notes, advance invoices, etc.)
Usage:?include=payments?include=payments,document_relations
When true, returns only soft-deleted (trashed) items. Default false excludes deleted items.
curl "https://eu.spaceinvoices.com/invoices" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
{
"data": [
{
"id": "inv_6595a27b5d35015c3ef0c402",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "DOC-2025-001",
"date": "2025-03-15T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"address": "1 Launchpad Way",
"city": "Cape Canaveral",
"state": "FL",
"post_code": "32920",
"country": "USA",
"country_code": "US",
"tax_number": "59-8765432"
},
"customer_id": "cus_6595a27b5d35015c3ef0c403",
"customer": {
"name": "Horizon Launch Systems Inc.",
"address": "100 Rocket Row",
"city": "Houston",
"state": "TX",
"post_code": "77058",
"country": "USA",
"country_code": "US",
"tax_number": "74-1234567"
},
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c402",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Ground Station Antenna Array",
"description": "Deep space tracking antenna with 12m dish",
"quantity": 2,
"price": 12500,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 25000,
"total_with_tax": 30500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"project_code": "MSN-2025-001",
"department": "Ground Operations"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
},
{
"id": "inv_item_6595a27b5d35015c3ef0c403",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Orbital Navigation License",
"description": "Annual software license for orbital trajectory planning",
"quantity": 1,
"price": 5000,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 5000,
"total_with_tax": 6100,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"license_type": "enterprise",
"seats": "50"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
}
],
"note": "Thank you for your order. Equipment ships within 5 business days.",
"reference": "PO-2025-001",
"total": 30000,
"total_with_tax": 36600,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"base": 30000,
"rate": 22,
"amount": 6600,
"reverse_charge": false,
"tax_id": null
}
],
"date_year": 2025,
"metadata": {
"project_id": "MSN-2025-001",
"contract_id": "ORB-2024-789"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2025-04-15T00:00:00.000Z",
"total_paid": 0,
"total_due": 36600,
"paid_in_full": false,
"furs": null,
"fina": null
}
],
"pagination": {
"total": 1,
"next_cursor": null,
"prev_cursor": null,
"has_more": false
}
}Get invoice by ID
/invoices/{id}Retrieve a single invoice by its unique identifier. Returns the complete invoice details including all line items, customer information, and calculated totals.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
Query parameters
Comma-separated list of relations to include in the response.
Available relations:
- payments - Payment records linked to this invoice
- document_relations - Linked documents (credit notes, advance invoices, etc.)
Usage:?include=payments?include=payments,document_relations
curl "https://eu.spaceinvoices.com/invoices/{id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_6595a27b5d35015c3ef0c402",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "DOC-2025-001",
"date": "2025-03-15T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"address": "1 Launchpad Way",
"city": "Cape Canaveral",
"state": "FL",
"post_code": "32920",
"country": "USA",
"country_code": "US",
"tax_number": "59-8765432"
},
"customer_id": "cus_6595a27b5d35015c3ef0c403",
"customer": {
"name": "Horizon Launch Systems Inc.",
"address": "100 Rocket Row",
"city": "Houston",
"state": "TX",
"post_code": "77058",
"country": "USA",
"country_code": "US",
"tax_number": "74-1234567"
},
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c402",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Ground Station Antenna Array",
"description": "Deep space tracking antenna with 12m dish",
"quantity": 2,
"price": 12500,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 25000,
"total_with_tax": 30500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"project_code": "MSN-2025-001",
"department": "Ground Operations"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
},
{
"id": "inv_item_6595a27b5d35015c3ef0c403",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Orbital Navigation License",
"description": "Annual software license for orbital trajectory planning",
"quantity": 1,
"price": 5000,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 5000,
"total_with_tax": 6100,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"license_type": "enterprise",
"seats": "50"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
}
],
"note": "Thank you for your order. Equipment ships within 5 business days.",
"reference": "PO-2025-001",
"total": 30000,
"total_with_tax": 36600,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"base": 30000,
"rate": 22,
"amount": 6600,
"reverse_charge": false,
"tax_id": null
}
],
"date_year": 2025,
"metadata": {
"project_id": "MSN-2025-001",
"contract_id": "ORB-2024-789"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2025-04-15T00:00:00.000Z",
"total_paid": 0,
"total_due": 36600,
"paid_in_full": false,
"furs": null,
"fina": null
}Update an invoice
/invoices/{id}Update an existing invoice.
Creates a version snapshot before applying changes.
Cannot update voided or FURS-fiscalized invoices.
If items are provided, they replace all existing items.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
Body parameters
Document date (YYYY-MM-DD or ISO datetime format).
Payment due date (YYYY-MM-DD or ISO datetime format). Set to null to clear.
Service/work date or start of service period. Set to null to clear.
Currency code (ISO 4217, 3 characters). Changing currency triggers exchange rate recalculation.
Referenced Customer ID. Set to null to remove customer reference.
Document note/memo. Set to null to clear.
Custom metadata object. Set to null to clear.
curl -X PATCH "https://eu.spaceinvoices.com/invoices/{id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"note": "Payment received. Thank you!",
"change_reason": "Added thank you note after payment"
}'Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_6595a27b5d35015c3ef0c402",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "DOC-2025-001",
"date": "2025-03-15T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"address": "1 Launchpad Way",
"city": "Cape Canaveral",
"state": "FL",
"post_code": "32920",
"country": "USA",
"country_code": "US",
"tax_number": "59-8765432"
},
"customer_id": "cus_6595a27b5d35015c3ef0c403",
"customer": {
"name": "Horizon Launch Systems Inc.",
"address": "100 Rocket Row",
"city": "Houston",
"state": "TX",
"post_code": "77058",
"country": "USA",
"country_code": "US",
"tax_number": "74-1234567"
},
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c402",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Ground Station Antenna Array",
"description": "Deep space tracking antenna with 12m dish",
"quantity": 2,
"price": 12500,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 25000,
"total_with_tax": 30500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"project_code": "MSN-2025-001",
"department": "Ground Operations"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
},
{
"id": "inv_item_6595a27b5d35015c3ef0c403",
"invoice_id": "inv_6595a27b5d35015c3ef0c402",
"advance_invoice_id": null,
"item_id": null,
"name": "Orbital Navigation License",
"description": "Annual software license for orbital trajectory planning",
"quantity": 1,
"price": 5000,
"gross_price": null,
"taxes": [
{
"rate": 22,
"tax_id": "tax_6595a27b5d35015c3ef0c402"
}
],
"discounts": [],
"type": null,
"unit": null,
"total": 5000,
"total_with_tax": 6100,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {
"license_type": "enterprise",
"seats": "50"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z"
}
],
"note": "Thank you for your order. Equipment ships within 5 business days.",
"reference": "PO-2025-001",
"total": 30000,
"total_with_tax": 36600,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"base": 30000,
"rate": 22,
"amount": 6600,
"reverse_charge": false,
"tax_id": null
}
],
"date_year": 2025,
"metadata": {
"project_id": "MSN-2025-001",
"contract_id": "ORB-2024-789"
},
"created_at": "2025-03-15T00:00:00.000Z",
"updated_at": "2025-03-15T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2025-04-15T00:00:00.000Z",
"total_paid": 0,
"total_due": 36600,
"paid_in_full": false,
"furs": null,
"fina": null
}Void an invoice
/invoices/{id}/voidVoid an invoice for technical reasons (duplicate, error, etc.). For FURS-fiscalized invoices, automatically submits technical cancellation to FURS and creates a credit note. For business corrections, create a credit note instead.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
Body parameters
curl -X POST "https://eu.spaceinvoices.com/invoices/{id}/void" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"reason": "Duplicate invoice created by mistake"
}'Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_abc123",
"voided_at": "2026-01-20T12:00:00.000Z"
}Get invoice version history
/invoices/{id}/versionsRetrieve the version history for an invoice. Each version represents the document state before an update was applied.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
curl "https://eu.spaceinvoices.com/invoices/{id}/versions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
{
"versions": [
{
"id": "ver_abc123",
"document_type": "invoice",
"document_id": "inv_6595a27b5d35015c3ef0c3fd",
"version": 2,
"snapshot": {
"id": "inv_6595a27b5d35015c3ef0c3fd",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "2026-00001",
"date": "2026-01-01T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"country": "United States",
"country_code": "US"
},
"customer_id": null,
"customer": null,
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c3fd",
"invoice_id": "inv_6595a27b5d35015c3ef0c3fd",
"advance_invoice_id": null,
"item_id": null,
"name": "Satellite Communication Module",
"description": null,
"quantity": 1,
"price": 1500,
"gross_price": null,
"taxes": [],
"discounts": [],
"type": null,
"unit": null,
"total": 1500,
"total_with_tax": 1500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"note": null,
"reference": null,
"total": 1500,
"total_with_tax": 1500,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"rate": null,
"tax_id": null,
"base": 1500,
"amount": 0,
"reverse_charge": false
}
],
"date_year": 2026,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2026-02-01T00:00:00.000Z",
"total_paid": 0,
"total_due": 1500,
"paid_in_full": false,
"furs": null,
"fina": null
},
"changed_fields": [
"note"
],
"user": {
"id": "usr_123",
"name": "John Doe",
"email": "john@example.com"
},
"reason": "Added payment confirmation",
"created_at": "2025-01-15T10:30:00.000Z"
},
{
"id": "ver_xyz789",
"document_type": "invoice",
"document_id": "inv_6595a27b5d35015c3ef0c3fd",
"version": 1,
"snapshot": {
"id": "inv_6595a27b5d35015c3ef0c3fd",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "2026-00001",
"date": "2026-01-01T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"country": "United States",
"country_code": "US"
},
"customer_id": null,
"customer": null,
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c3fd",
"invoice_id": "inv_6595a27b5d35015c3ef0c3fd",
"advance_invoice_id": null,
"item_id": null,
"name": "Satellite Communication Module",
"description": null,
"quantity": 1,
"price": 1500,
"gross_price": null,
"taxes": [],
"discounts": [],
"type": null,
"unit": null,
"total": 1500,
"total_with_tax": 1500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"note": null,
"reference": null,
"total": 1500,
"total_with_tax": 1500,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"rate": null,
"tax_id": null,
"base": 1500,
"amount": 0,
"reverse_charge": false
}
],
"date_year": 2026,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2026-02-01T00:00:00.000Z",
"total_paid": 0,
"total_due": 1500,
"paid_in_full": false,
"furs": null,
"fina": null
},
"changed_fields": [
"items"
],
"user": {
"id": "usr_123",
"name": "John Doe",
"email": "john@example.com"
},
"reason": "Corrected line items",
"created_at": "2025-01-14T15:00:00.000Z"
}
],
"count": 2
}Get specific invoice version
/invoices/{id}/versions/{version}Retrieve a specific version snapshot of an invoice.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Invoice ID
Version number
curl "https://eu.spaceinvoices.com/invoices/{id}/versions/{version}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
Version record ID
{
"id": "ver_abc123",
"document_type": "invoice",
"document_id": "inv_6595a27b5d35015c3ef0c3fd",
"version": 1,
"snapshot": {
"id": "inv_6595a27b5d35015c3ef0c3fd",
"entity_id": "ent_6595a27b5d35015c3ef0c3fd",
"number": "2026-00001",
"date": "2026-01-01T00:00:00.000Z",
"currency_code": "USD",
"issuer": {
"name": "Starward Equipment Co.",
"country": "United States",
"country_code": "US"
},
"customer_id": null,
"customer": null,
"items": [
{
"id": "inv_item_6595a27b5d35015c3ef0c3fd",
"invoice_id": "inv_6595a27b5d35015c3ef0c3fd",
"advance_invoice_id": null,
"item_id": null,
"name": "Satellite Communication Module",
"description": null,
"quantity": 1,
"price": 1500,
"gross_price": null,
"taxes": [],
"discounts": [],
"type": null,
"unit": null,
"total": 1500,
"total_with_tax": 1500,
"total_converted": null,
"total_with_tax_converted": null,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"note": null,
"reference": null,
"total": 1500,
"total_with_tax": 1500,
"total_discount": 0,
"total_converted": null,
"total_with_tax_converted": null,
"shareable_id": null,
"taxes": [
{
"rate": null,
"tax_id": null,
"base": 1500,
"amount": 0,
"reverse_charge": false
}
],
"date_year": 2026,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"voided_at": null,
"deleted_at": null,
"exchange_rate": null,
"rounding_correction": null,
"transaction_type": "domestic",
"vies": null,
"tax_clause": null,
"signature": "{entity_name}",
"payment_terms": null,
"date_due": "2026-02-01T00:00:00.000Z",
"total_paid": 0,
"total_due": 1500,
"paid_in_full": false,
"furs": null,
"fina": null
},
"changed_fields": [
"items"
],
"user": {
"id": "usr_123",
"name": "John Doe",
"email": "john@example.com"
},
"reason": "Corrected line items",
"created_at": "2025-01-14T15:00:00.000Z"
}Preview next document number
/documents/next-numberPreview the next auto-generated document number for the specified type without incrementing the sequence. Useful for showing users what number will be assigned before creating a document.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Query parameters
Document type
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
Business premise name (FURS or FINA). If provided with electronic_device_name, returns fiscalization-format number.
Electronic device name (FURS or FINA). Required if business_premise_name is provided. When provided, returns fiscalization-format number.
curl "https://eu.spaceinvoices.com/documents/next-number" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
{
"number": "2026-00042",
"furs": null
}Render invoice preview
/invoices/renderRender an HTML preview of an invoice without saving to the database. Perfect for displaying live previews in invoice creation/edit forms. Supports both partial mode (allows incomplete data for drafts) and complete mode (validates all required fields).
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Query parameters
Document template design to use. When not specified, uses the entity's configured template.
Possible values: "modern", "classic", "condensed", "minimal", "fashion"
Locale for number and date formatting (decimal separators, date order). When not specified, uses the entity's configured locale. For example, 'sl-SI' formats decimals with commas (5,5%) and dates as DD. MM. YYYY.
Language for document labels and translations (e.g., 'Invoice', 'Tax', 'Total'). When not specified, uses the same value as locale. Use this to get entity-locale formatting with different-language labels — for example, a Slovenian entity (sl-SI formatting with commas) but English labels.
Whether to treat the document as partial (allows incomplete data) or complete (validates all required fields)
Possible values: "true", "false"
Default: "true"
Override UPN QR enabled setting for preview
Possible values: "true", "false"
Override UPN QR display mode for preview
Possible values: "qr_only", "full_slip"
Override EPC QR enabled setting for preview
Possible values: "true", "false"
Body parameters
Document date in YYYY-MM-DD format
Document due date in YYYY-MM-DD format
Service date in YYYY-MM-DD format. For invoices and credit notes.
Referenced Customer ID. Required if customer is not provided.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
curl -X POST "https://eu.spaceinvoices.com/invoices/render" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"name": "Consulting Services",
"quantity": 5,
"price": 150
}
],
"customer": {
"name": "Acme Corp"
}
}'Preview document calculation
/documents/calculateCalculate document totals, taxes, and transaction type without creating the document. Useful for showing live totals in forms or validating data before submission.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Query parameters
Document type
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
Body parameters
curl -X POST "https://eu.spaceinvoices.com/documents/calculate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"name": "Web Development",
"quantity": 10,
"price": 100,
"taxes": [
{
"rate": 22
}
]
}
]
}'Returns
{
"items": [
{
"name": "Web Development",
"description": null,
"type": null,
"price": 100,
"gross_price": null,
"quantity": 10,
"unit": null,
"taxes": [
{
"name": "VAT",
"rate": 22,
"base": 1000,
"amount": 220
}
],
"discounts": [],
"total": 1000,
"total_with_tax": 1220,
"total_converted": null,
"total_with_tax_converted": null
}
],
"total": 1000,
"total_with_tax": 1220,
"total_discount": 0,
"taxes": [
{
"name": "VAT",
"rate": 22,
"base": 1000,
"amount": 220,
"reverse_charge": false
}
],
"transaction_type": "domestic",
"currency_code": "EUR",
"exchange_rate": null,
"total_converted": null,
"total_with_tax_converted": null,
"rounding_correction": null,
"vies": null
}Render HTML
/documents/{id}/htmlRender a saved document by its ID as HTML. The document type is automatically detected from the ID prefix (inv_, est_, cre_, adv_). The output is styled for professional presentation and optimized for display in web applications.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
Query parameters
Document template design to use. When not specified, uses the entity's configured template.
Possible values: "modern", "classic", "condensed", "minimal", "fashion"
Locale for number and date formatting (decimal separators, date order). When not specified, uses the entity's configured locale. For example, 'sl-SI' formats decimals with commas (5,5%) and dates as DD. MM. YYYY.
Language for document labels and translations (e.g., 'Invoice', 'Tax', 'Total'). When not specified, uses the same value as locale. Use this to get entity-locale formatting with different-language labels — for example, a Slovenian entity (sl-SI formatting with commas) but English labels.
curl "https://eu.spaceinvoices.com/documents/{id}/html" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Render PDF
/documents/{id}/pdfRender a saved document by its ID as PDF. The document type is automatically detected from the ID prefix (inv_, est_, cre_, adv_). The output is styled for professional presentation and optimized for printing. Ideal for downloads and archival.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
Query parameters
Document template design to use. When not specified, uses the entity's configured template.
Possible values: "modern", "classic", "condensed", "minimal", "fashion"
Locale for number and date formatting (decimal separators, date order). When not specified, uses the entity's configured locale. For example, 'sl-SI' formats decimals with commas (5,5%) and dates as DD. MM. YYYY.
Language for document labels and translations (e.g., 'Invoice', 'Tax', 'Total'). When not specified, uses the same value as locale. Use this to get entity-locale formatting with different-language labels — for example, a Slovenian entity (sl-SI formatting with commas) but English labels.
curl "https://eu.spaceinvoices.com/documents/{id}/pdf" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Finalize a draft document
/documents/{id}/finalizeFinalize a draft document by assigning a document number and running fiscalization (if applicable). Only draft documents can be finalized. After finalization, the document cannot be deleted.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Document ID
Query parameters
Document type. Optional — automatically inferred from the document ID prefix.
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
Body parameters
curl -X POST "https://eu.spaceinvoices.com/documents/{id}/finalize" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID" \
-H "Content-Type: application/json" \
-d '{
"fina": {
"business_premise_name": "PP1",
"electronic_device_name": "1",
"payment_type": "card"
}
}'nullDelete a draft document
/documents/{id}Delete a draft document. Only draft documents can be deleted. Finalized documents cannot be deleted - use void instead.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Document ID
Query parameters
Document type. Optional — automatically inferred from the document ID prefix.
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
curl -X DELETE "https://eu.spaceinvoices.com/documents/{id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Permanently delete a document
/documents/{id}/permanentPermanently delete a soft-deleted document. Only documents in the trash can be permanently deleted. Only draft documents and estimates can be permanently deleted.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Document ID
Query parameters
Document type. Optional — automatically inferred from the document ID prefix.
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
curl -X DELETE "https://eu.spaceinvoices.com/documents/{id}/permanent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Fiscalize an old invoice
/invoices/{id}/fiscalizeManually fiscalize an invoice that was created before FURS was enabled. Auto-creates a dedicated "OLD" premise and device for FURS submission, assigns a new sequential FURS number (OLD-OLD-N), and submits to FURS with SubsequentSubmit=true and SpecialNotes=#OLDINV;. The original invoice number remains unchanged.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Unique resource identifier
curl -X POST "https://eu.spaceinvoices.com/invoices/{id}/fiscalize" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"Returns
Date the invoice was created (ISO 8601 datetime at midnight UTC)
Date the invoice is due (ISO 8601 datetime at midnight UTC)
Service date in YYYY-MM-DD format. For invoices and credit notes.
Note for the document. If not provided, defaults to entity's document-type-specific note setting. Pass empty string to explicitly set no note.
Custom key-value data for your own use. Store any JSON object up to 50 properties. Values must be strings up to 250 characters. Useful for storing external IDs, tags, or integration data.
{
"id": "inv_abc123",
"furs": {
"country_code": "SI",
"status": "success",
"fiscalized_at": "2026-01-20T12:00:00.000Z",
"data": {
"zoi": "a1b2c3d4e5f6...",
"eor": "EOR-12345",
"business_premise_name": "OLD",
"electronic_device_name": "OLD",
"invoice_number": "1"
}
}
}Retry document fiscalization
/documents/{id}/fiscalizeManually retry fiscalization for a document that has a failed fiscalization status. Only documents with failed FURS or FINA fiscalization can be retried.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Document ID
Query parameters
Document type. Optional — automatically inferred from the document ID prefix.
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
curl -X POST "https://eu.spaceinvoices.com/documents/{id}/fiscalize" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"nullRestore a deleted document
/documents/{id}/restoreRestore a soft-deleted document from the trash. The document will be returned to its original state.
Header parameters
Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.
Path parameters
Document ID
Query parameters
Document type. Optional — automatically inferred from the document ID prefix.
Possible values: "invoice", "estimate", "credit_note", "advance_invoice", "delivery_note"
curl -X POST "https://eu.spaceinvoices.com/documents/{id}/restore" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-entity-id: YOUR_ENTITY_ID"null