get
/api/v1/businessProfil entreprise
Responses
- 200OK
Quickstart
Generate an API key from your account settings, then call the API with the X-Api-Key header.
curl
curl -X POST https://app.fastfaktura.io/api/v1/invoices \
-H "X-Api-Key: ffk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"client_id": "1f0c4a9e-…",
"currency": "EUR",
"lines": [
{ "description": "Consulting", "quantity": 1, "unit_price_cents": 50000, "tax_rate": 20 }
]
}'Authentication
Every request must include your API key, either in the X-Api-Key header or as a Bearer token. Both methods are equivalent.
X-Api-Key
curl https://app.fastfaktura.io/api/v1/clients \ -H "X-Api-Key: ffk_xxxxxxxx"
Authorization: Bearer
curl https://app.fastfaktura.io/api/v1/clients \ -H "Authorization: Bearer ffk_xxxxxxxx"
Endpoints
Business
put
/api/v1/businessMise à jour du profil
Responses
- 200OK
Clients
get
/api/v1/clientsListe des clients
Parameters
pagequery | integer | |
qquery | string | Recherche nom/email/téléphone |
Responses
- 200OK
post
/api/v1/clientsCréation client
Responses
- 201Créé
get
/api/v1/clients/{id}Détail client
Responses
- 200OK
- 404Introuvable
put
/api/v1/clients/{id}Édition client
Responses
- 200OK
delete
/api/v1/clients/{id}Archivage client (pas de suppression définitive)
Responses
- 200OK
Invoices
get
/api/v1/invoicesListe des factures
Parameters
pagequery | integer | |
statusquery | string |
Responses
- 200OK
post
/api/v1/invoicesCréation facture (avec lignes)
Request body
| Field | Type | Description |
|---|---|---|
client_idrequired | uuid | |
currencyrequired | string | |
due_date | string | null | |
notes | string | null | |
linesrequired | InvoiceLine[] |
Responses
- 201Créée
get
/api/v1/invoices/{id}Détail facture + lignes + événements
Responses
- 200OK
get
/api/v1/invoices/{id}/pdfPDF de la facture
Responses
- 200application/pdf
post
/api/v1/invoices/{id}/sendEnvoi (email / sms / lien), mode normal ou rappel
Request body
| Field | Type | Description |
|---|---|---|
channelsrequired | string[] | |
reminder | boolean |
Responses
- 200OK (sandbox: envoi simulé)
get
/api/v1/invoices/{id}/eventsTimeline d'événements
Responses
- 200OK
Schemas
Structure of the objects accepted and returned by the API.
Client
| Field | Type | Description |
|---|---|---|
id | uuid | |
name | string | |
email | string | null | |
phone | string | null | E.164 |
address | string | null | |
country | string | null | |
locale | string | frennbsv |
external_id | string | null | |
tags | string[] | |
archived_at | string | null |
InvoiceLine
| Field | Type | Description |
|---|---|---|
descriptionrequired | string | |
quantityrequired | number | |
unit_price_centsrequired | integer | Centimes |
tax_raterequired | number | Pourcentage (ex. 20) |
Invoice
| Field | Type | Description |
|---|---|---|
id | uuid | |
number | string | |
client_id | uuid | |
currency | string | EURUSDGBPNOKSEKDKK |
subtotal_cents | integer | |
tax_cents | integer | |
total_cents | integer | |
status | string | draftsentopenedpaidoverduecancelled |
due_date | string | null | |
public_url | string |