An **Invoice Document** is a file attached to an **Invoice**, such as the invoice PDF or supporting evidence. At least one document is required before an invoice can be checked; documents can be uploaded, downloaded and, under certain conditions, deleted.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/alasco-invoice-document-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Alasco Invoice Document API
version: '1.0'
x-logo:
url: https://assets-global.website-files.com/656ef2eb27ad41897248f866/659eebec190ae7aaf4162f09_Logotype_Alasco_white_RGB%202.png
description: 'Operations tagged Invoice Document across 2 of this provider''s published API definitions: alasco-capex-openapi.json, alasco-fincon-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.alasco.de/capex/v1
- url: https://api.alasco.de/fincon/v1
tags:
- description: An **Invoice Document** is a file attached to an **Invoice**, such as the invoice PDF or supporting evidence. At least one document is required before an invoice can be checked; documents can be uploaded, downloaded and, under certain conditions, deleted.
name: Invoice Document
paths:
/invoices/{invoice_id}/documents/:
get:
operationId: get_invoice_documents_invoices__invoice_id__documents__get
parameters:
- in: path
name: invoice_id
required: true
schema:
format: uuid
title: Invoice Id
type: string
- description: '
You can filter on certain attributes by specifying them as a GET parameter along
with an operation, e.g. `filter[name.exact]=abc`.
Currently supported operations are:
* `less_than_equal`: Expects one value
* `greater_than_equal`: Expects one value
* `range`: Expects two values
* `in`: Expects one or multiple values
* `not_in`: Expects one or multiple values
The following attributes support filtering:
| **Attribute** | `less_than_equal` | `greater_than_equal` | `range` | `in` | `not_in` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `document_type` | | | | x | x |
| `uploaded_at` | x | x | x | | |
'
in: query
name: filter[attribute.operation]
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '
You can filter on certain attributes by specifying them as a GET parameter along
with an operation, e.g. `filter[name.exact]=abc`.
Currently supported operations are:
* `less_than_equal`: Expects one value
* `greater_than_equal`: Expects one value
* `range`: Expects two values
* `in`: Expects one or multiple values
* `not_in`: Expects one or multiple values
The following attributes support filtering:
| **Attribute** | `less_than_equal` | `greater_than_equal` | `range` | `in` | `not_in` |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `document_type` | | | | x | x |
| `uploaded_at` | x | x | x | | |
'
title: Filter[Attribute.Operation]
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/InvoiceDocumentListResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Get Invoice Documents
tags:
- Invoice Document
post:
operationId: create_invoice_document_invoices__invoice_id__documents__post
parameters:
- in: path
name: invoice_id
required: true
schema:
format: uuid
title: Invoice Id
type: string
requestBody:
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_create_invoice_document_invoices__invoice_id__documents__post'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/InvoiceDocumentResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Create Invoice Document
tags:
- Invoice Document
servers:
- url: https://api.alasco.de/capex/v1
/invoices/{invoice_id}/documents/{document_id}/:
get:
operationId: get_invoice_document_invoices__invoice_id__documents__document_id___get
parameters:
- in: path
name: invoice_id
required: true
schema:
format: uuid
title: Invoice Id
type: string
- in: path
name: document_id
required: true
schema:
format: uuid
title: Document Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/InvoiceDocumentResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Get Invoice Document
tags:
- Invoice Document
servers:
- url: https://api.alasco.de/capex/v1
/invoices/{invoice_id}/documents/{document_id}/download-annotated/:
get:
operationId: download_annotated_invoice_document_invoices__invoice_id__documents__document_id__download_annotated__get
parameters:
- in: path
name: invoice_id
required: true
schema:
format: uuid
title: Invoice Id
type: string
- in: path
name: document_id
required: true
schema:
format: uuid
title: Document Id
type: string
responses:
'200':
description: '
Returns the document with annotations if available, otherwise returns the original document.
'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Download Annotated Invoice Document
tags:
- Invoice Document
servers:
- url: https://api.alasco.de/capex/v1
/invoices/{invoice_id}/documents/{document_id}/download/:
get:
operationId: download_invoice_document_invoices__invoice_id__documents__document_id__download__get
parameters:
- in: path
name: invoice_id
required: true
schema:
format: uuid
title: Invoice Id
type: string
- in: path
name: document_id
required: true
schema:
format: uuid
title: Document Id
type: string
responses:
'302':
description: '
Redirect to the temporary download link
'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Download Invoice Document
tags:
- Invoice Document
servers:
- url: https://api.alasco.de/capex/v1
components:
schemas:
InvoiceDocumentData:
properties:
attributes:
$ref: '#/components/schemas/InvoiceDocumentAttributes'
id:
format: uuid
title: Id
type: string
links:
$ref: '#/components/schemas/InvoiceDocumentDataLinks'
relationships:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
description: '
Contains links to related objects.
'
examples:
- invoice:
data:
id: 503671b0-c9b4-47a9-b859-763fcf8a9f28
type: INVOICE
title: Relationships
type:
default: INVOICE_DOCUMENT
title: Type
type: string
required:
- id
- attributes
- links
title: InvoiceDocumentData
type: object
InvoiceDocumentResponse:
properties:
data:
anyOf:
- $ref: '#/components/schemas/InvoiceDocumentData'
- type: 'null'
errors:
anyOf:
- items:
$ref: '#/components/schemas/Error'
type: array
- type: 'null'
title: Errors
included:
anyOf:
- items:
$ref: '#/components/schemas/BaseDataSchema'
type: array
- type: 'null'
title: Included
links:
anyOf:
- additionalProperties:
anyOf:
- type: string
- type: 'null'
type: object
- type: 'null'
title: Links
title: InvoiceDocumentResponse
type: object
InvoiceDocumentReadType:
description: 'This used for reading document invoice types and some other extra types such as `COVERSHEET`,
`COMPOSED_DOCUMENTS`, `GUARANTEE` and `FINAL_INVOICE` in addition to the invoice document types and this
one being used to read data only not for creation.'
enum:
- INVOICE
- ATTACHMENT
- COVERSHEET_EXTERNAL
- AUDITED_INVOICE
- INTERNAL_CORRESPONDENCE
- EXTERNAL_CORRESPONDENCE
- VALUATIONS
- PLANS
- REVISED_INVOICE
- PAYMENT_CERTIFICATE
- PROTOCOL
- OTHER
- FINAL_INVOICE
- GUARANTEE
- COVERSHEET
- COMPOSED_DOCUMENTS
- EINVOICE_VISUALIZATION
title: InvoiceDocumentReadType
type: string
ValidationError:
properties:
ctx:
title: Context
type: object
input:
title: Input
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
Body_create_invoice_document_invoices__invoice_id__documents__post:
properties:
document_type:
$ref: '#/components/schemas/InvoiceDocumentCreateType'
description: 'Available values / Verfügbare Werte:
| Value | English | Deutsch |
| --- | --- | --- |
| `INVOICE` | Invoice | Rechnung |
| `ATTACHMENT` | Attachment | Anhang |
| `COVERSHEET_EXTERNAL` | External coversheet | Externes Deckblatt |
| `AUDITED_INVOICE` | Audited invoice | Prüfrechnung |
| `INTERNAL_CORRESPONDENCE` | Internal correspondence | Interne Korrespondenz |
| `EXTERNAL_CORRESPONDENCE` | External correspondence | Externe Korrespondenz |
| `VALUATIONS` | Valuations | Aufmaß |
| `PLANS` | Plans | Planunterlagen |
| `REVISED_INVOICE` | Revised invoice | Korrekturrechnung |
| `PAYMENT_CERTIFICATE` | Payment certificate | Zahlungsnachweis |
| `PROTOCOL` | Protocol | Protokoll |
| `OTHER` | Other | Sonstiges |'
upload:
contentMediaType: application/octet-stream
description: '
The file to submit. The file must be a valid PDF.
'
title: Upload
type: string
required:
- document_type
- upload
title: Body_create_invoice_document_invoices__invoice_id__documents__post
type: object
InvoiceDocumentDataLinks:
properties:
download:
examples:
- https://api.alasco.de/capex/v1/invoices/<invoice_id>/documents/<document_id>/download/
title: Download
type: string
download_annotated:
examples:
- https://api.alasco.de/capex/v1/invoices/<invoice_id>/documents/<document_id>/download-annotated/
title: Download Annotated
type: string
self:
examples:
- https://api.alasco.de/capex/v1/invoices/<invoice_id>/documents/<document_id>/
title: Self
type: string
required:
- self
- download
- download_annotated
title: InvoiceDocumentDataLinks
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
BaseDataSchema:
properties:
attributes:
anyOf:
- {}
- type: 'null'
title: Attributes
id:
format: uuid
title: Id
type: string
relationships:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Relationships
type:
title: Type
type: string
required:
- id
- type
title: BaseDataSchema
type: object
Error:
properties:
detail:
anyOf:
- type: string
- type: 'null'
title: Detail
source:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Source
status:
anyOf:
- type: string
- type: 'null'
title: Status
title:
anyOf:
- type: string
- type: 'null'
title: Title
title: Error
type: object
InvoiceDocumentAttributes:
properties:
document_type:
$ref: '#/components/schemas/InvoiceDocumentReadType'
description: '**Document type** · **Dokumentenart**
Available values / Verfügbare Werte:
| Value | English | Deutsch |
| --- | --- | --- |
| `INVOICE` | Invoice | Rechnung |
| `ATTACHMENT` | Attachment | Anhang |
| `COVERSHEET_EXTERNAL` | External coversheet | Externes Deckblatt |
| `AUDITED_INVOICE` | Audited invoice | Prüfrechnung |
| `INTERNAL_CORRESPONDENCE` | Internal correspondence | Interne Korrespondenz |
| `EXTERNAL_CORRESPONDENCE` | External correspondence | Externe Korrespondenz |
| `VALUATIONS` | Valuations | Aufmaß |
| `PLANS` | Plans | Planunterlagen |
| `REVISED_INVOICE` | Revised invoice | Korrekturrechnung |
| `PAYMENT_CERTIFICATE` | Payment certificate | Zahlungsnachweis |
| `PROTOCOL` | Protocol | Protokoll |
| `OTHER` | Other | Sonstiges |
| `FINAL_INVOICE` | Final invoice | Schlussrechnung |
| `GUARANTEE` | Guarantee | Bürgschaft |
| `COVERSHEET` | Cover sheet | Deckblatt |
| `COMPOSED_DOCUMENTS` | Composed documents | Zusammengefügte Dokumente |
| `EINVOICE_VISUALIZATION` | E-Invoice visualization | Visualisierung von E-Rechnungen |'
examples:
- INVOICE
filename:
description: '**Filename** · **Dateiname**'
title: Filename
type: string
uploaded_at:
description: '**Uploaded at** · **Hochgeladen am**'
format: date-time
title: Uploaded At
type: string
required:
- filename
- uploaded_at
- document_type
title: InvoiceDocumentAttributes
type: object
InvoiceDocumentListResponse:
properties:
data:
items:
$ref: '#/components/schemas/InvoiceDocumentData'
title: Data
type: array
errors:
anyOf:
- items:
$ref: '#/components/schemas/Error'
type: array
- type: 'null'
title: Errors
included:
anyOf:
- items:
$ref: '#/components/schemas/BaseDataSchema'
type: array
- type: 'null'
title: Included
links:
anyOf:
- additionalProperties:
anyOf:
- type: string
- type: 'null'
type: object
- type: 'null'
title: Links
required:
- data
title: InvoiceDocumentListResponse
type: object
InvoiceDocumentCreateType:
description: 'Invoice documents can be of different types. The file which is uploaded to Alasco when a new
invoice is created is of type `INVOICE`. All other documents which are added to the invoice in
Alasco later on can be of type `INVOICE`, `ATTACHMENT`, `AUDITED_INVOICE`, `EXTERNAL_CORRESPONDENCE`,
`INTERNAL_CORRESPONDENCE`, `VALUATIONS`, `PLANS`, `REVISED_INVOICE`, `PAYMENT_CERTIFICATE`,
`COVERSHEET_EXTERNAL`, `PROTOCOL` and `OTHER`.
If the invoice is of invoice type `RETAINAGE_PAYOUT` the guarantee which was used to start the
payout process is added to the invoice documents with the type `GUARANTEE`.'
enum:
- INVOICE
- ATTACHMENT
- COVERSHEET_EXTERNAL
- AUDITED_INVOICE
- INTERNAL_CORRESPONDENCE
- EXTERNAL_CORRESPONDENCE
- VALUATIONS
- PLANS
- REVISED_INVOICE
- PAYMENT_CERTIFICATE
- PROTOCOL
- OTHER
title: InvoiceDocumentCreateType
type: string
InvoiceDocumentDataLinks_2:
properties:
download:
examples:
- https://api.alasco.de/fincon/v1/invoices/<invoice_id>/documents/<document_id>/download/
title: Download
type: string
download_annotated:
examples:
- https://api.alasco.de/fincon/v1/invoices/<invoice_id>/documents/<document_id>/download-annotated/
title: Download Annotated
type: string
self:
examples:
- https://api.alasco.de/fincon/v1/invoices/<invoice_id>/documents/<document_id>/
title: Self
type: string
required:
- self
- download
- download_annotated
title: InvoiceDocumentDataLinks
type: object
securitySchemes:
API_Key:
description: '
The Alasco API uses a combination of API keys and API tokens to authenticate requests. The API key
needs to be sent in a header field called `X-API-KEY`.
'
in: header
name: X-API-KEY
type: apiKey
API_Token:
description: '
In addition to an API key, one has to specify an API token. There can be one or more tokens in use
for the same API key. The token needs to be sent in a header field called `X-API-TOKEN`.
Right now, it''s not possible to create API keys and API tokens from within Alasco.
If you are interested in using the Alasco API, please reach out to the
[support team](mailto:support@alasco.de). They will assist you in generating a key and token pair.
'
in: header
name: X-API-TOKEN
type: apiKey
x-refined-from:
- alasco-capex-openapi.json
- alasco-fincon-openapi.json