Developers
Booking API: integrate Daytio into a website
Building or managing the website of a professional who uses Daytio? Three ways to add their booking, from the simplest to the most complete. Your developer key is created right here, in two minutes, without writing to us.
Three ways to integrate
Get started in 2 minutes
Create your developer key yourself: name, email, then the 6-digit code you receive. Free, no approval from us. The key shows up straight away.
Then, with your key:
- The professional already has a Daytio account: they type their address on your website, receive a code by email and type it in — their account is linked (see “Link a professional's account”). Free for them, it's included in their plan.
- They don't have one: create it through the API (POST /accounts); they receive an email to choose their password.
- Book for your visitors with your key and the Daytio-Account header: appointments land in their calendar.
Step by step
- 1
Pick the integration
A simple button? Copy the link (section 1). Booking inside the page? Copy the widget code (section 2) — both are included in the professional's plan, nothing to request. A custom flow, or your visitors' records? You need the API: step 2.
- 2
Create your developer key
“Get started in 2 minutes” section: name, email, code received by email. Your partner key (dtp_live_…) shows up straight away, once. Free, nothing to request.
- 3
Link the professional's account
They have an account: they type their Daytio address on your website, you call POST /auth/code, they receive a 6-digit code and type it in; POST /auth/token returns their account id and a token. They don't: create it with POST /accounts.
- 4
Check everything works
A first call, with your key and the account id, should return the business name:
curl https://daytio.com/api/v1/business \ -H "Authorization: Bearer dtp_live_…" \ -H "Daytio-Account: 9b1e…" - 5
Build the flow
List the services, show free slots for the chosen one, then book. If the service requires online payment, redirect the client to the returned Stripe link: they come back to your website afterwards.
1. The booking link
Every professional has a permanent address. Add ?prestation=<service name> to preselect a service.
https://daytio.com/votre-salon
https://daytio.com/votre-salon?prestation=Coupe%20femme2. The widget
Paste these two lines where you want it. The script creates the frame and sizes it automatically — don't hand-write an <iframe>. Available blocks: reservation, horaires (opening hours), plus carte and commande for restaurants.
<div data-daytio="reservation" data-slug="votre-salon"></div>
<script src="https://daytio.com/embed.js" async></script>Framed content isn't indexed with the page that contains it: the widget drives bookings, not search rankings.
3. The API
Free for a professional's website · key in 2 minutes
The professional's full API (their whole clientele): €25/month, by bank transfer · Request the full API
Base URL
https://daytio.com/api/v1Authentication
Every request carries the key in the Authorization header (or X-Daytio-Key). A business key (dtk_live_…) identifies the professional: no other identifier needed. A partner key (dtp_live_…) targets the account named in the Daytio-Account header.
Authorization: Bearer dtk_live_…
# ou / or
X-Daytio-Key: dtk_live_…Browser or server calls
From a browser, the Origin header must match a website declared on the key, otherwise the request is refused (origin_not_allowed). A key in JavaScript is readable by every visitor: this list is what stops another site from using it. A key that opens client records, and any partner key, are refused from a browser (server_side_only): use them from a server only. A key that declares websites is treated as PUBLIC, even when called from a server: its limits are counted per device. For server calls, create a second key with no website declared.
API functions
A business's access includes one or more functions, ticked when requesting it; each key only opens the ones ticked when it was created. Client-record and Accounting functions are RESERVED FOR THE PROFESSIONAL themselves (and for accounts created by a validated partner platform): a developer key only opens booking. A route called without its function returns 403 module_not_enabled.
Booking(always included)
reservationThe business, its services, team members and free slots, booking and online payment.
Read client records(professional only)
clients_readName, email, phone, address, notes, status — with search.
Create and update client records(professional only)
clients_writeFrom the professional's software or website: one record per email address.
Client history(professional only)
client_historyTheir past and upcoming appointments, cancelled ones included.
Accounting(professional only)
accountingEverything the Accounting screen does: settings, quotes (sending, online acceptance), invoices and credit notes, other sales, sales to report (CSV and official XML), yearly export. Pro plan, professionals based in France.
A professional's website linked by a developer (partner key, account linked by code or by “Sign in with Daytio”) is FREE: it's included in the professional's plan, like the widget. The professional's full API — their whole clientele, with THEIR key — is opened by Daytio once the transfer is received, and cut if payment doesn't follow (403 api_access_inactive): their keys then stop responding, nothing is deleted.
Limits
Per key: 300 reads per minute, 120 bookings and 600 client-record writes per hour. Per partner: 50 accounts created per day (5 until a self-registered partner has been approved by Daytio). A key that declares websites (a public key, placed in a page) counts its reads per device, and the Daytio page's per-device limit applies to its bookings — whether they come from a browser or not. Beyond that: 429 rate_limited.
Response format
JSON. Success: { "data": … }. Error: { "error": { "code", "message" } }. Test the code, which is stable; the message (in French) may change.
Times and time zone
Instants are ISO 8601 (UTC). Show the client the time field, the professional's local time: it is the one that counts, as the client travels to them.
Endpoints
GET /businessThe business: name, city, time zone, currency, booking rules, online payment.reservationGET /servicesBookable services, in the professional's order.reservationGET /staffTeam members (Team plan). Empty list for a solo professional.reservationGET /availabilityFree slots, 1 to 7 days. Parameters: services (comma-separated ids), from (YYYY-MM-DD), days, staff, anyStaff=1.reservationPOST /bookingsBooks a slot. The slot is re-checked at booking time.reservationGET /payments/{sessionId}Status of a booking paid online.reservationPOST /requestsLeaves a contact or quote request in the professional's “Requests” screen (badge in their menu, email to the professional). Body: fullName and phone required; email, businessName, message (2,000 characters) optional. The “Requests” module is turned on per professional, on request to Daytio.reservationGET /clientsClient records. Parameters: q (search), limit (≤ 100), offset, updatedSince.clients_readGET /clients/{id}One client record.clients_readPOST /clientsCreates a record. 409 client_exists if the email is already known (clientId provided).clients_writePATCH /clients/{id}Updates a record: only the fields sent change, null clears.clients_writeGET /clients/{id}/appointmentsA client's appointments. Parameters: from, to (ISO dates), limit (≤ 200).client_historyPOST /accountsPartners: creates a professional's Daytio account. Options: spaceUrl (their space is on your website, validated partner) and bookingPage (false: no booking on daytio.com).partnerGET /accountsPartners: the accounts you manage (relation field: “created” for those you created).partnerPOST /auth/codePartners: emails the professional a 6-digit sign-in code (1 h). Body: { email }. Same response whether the address has an account or not.partnerPOST /auth/tokenPartners: exchanges the code (email, or “Sign in with Daytio” return) for the account id and a 12-hour token.partnerDELETE /auth/tokenSign-out: the session token presented stops working.partnerGET /partnerPartners: your account — client_id, name, declared websites, account cap.partnerPATCH /partnerPartners: replaces your websites (return addresses). Body: { sites: ["https://…"] }.partnerPATCH /businessUpdates the profile: name, description, category, phone, email (public contact), website, address, addressComplement, postalCode, city, siret (14 digits, check digit verified), legalForm, showFullAddress, brandColor (#RRGGBB or null), slug (booking link), bookingPage (booking on the daytio.com page, true or false). GET /business also returns these fields (profile object).accountPOST /business/logoNew logo, as multipart/form-data (field logo): PNG, JPEG or WEBP, 5 MB max.accountDELETE /business/logoRemoves the logo.accountGET /services?status=allEvery service, deactivated ones included, with their state (active).accountPOST /servicesCreates a service: name, durationMinutes (multiple of 5, 5 to 480), price (null = no price), description, category, active, onlinePaymentRequired, staffIds.accountPATCH /services/{id}Updates a service: only the fields sent change. { active: false } removes it from booking.accountDELETE /services/{id}Deletes a service (past appointments keep their title).accountGET /appointmentsThe calendar: appointments over a period, with the client. Parameters: from, to (YYYY-MM-DD, inclusive, one year max), status (confirmed, cancelled, all), clientId, limit (≤ 200), offset. Linked professional: only the appointments booked on your website.accountGET /statsRevenue and appointments by day, week (Monday → Sunday) or month, in the professional's time zone — the bars of the Daytio dashboard. Parameters: granularity (day, week, month; month by default), from, to (YYYY-MM for months, YYYY-MM-DD otherwise; default 14 days, 8 weeks or 12 months; at most 366 days, 104 weeks or 24 months). totals = the whole period.accountGET /stats/summaryThe dashboard home in one call: revenue for today, this week and this month, today's and upcoming appointments, number of clients, 30-day cancellation rate.accountGET /relancesFollow-ups to show as notifications. Parameters: status (todo by default, done, cancelled, all), dueBefore (YYYY-MM-DD), clientId, limit, offset.managedPOST /relancesSchedules a follow-up: clientId, dueOn (YYYY-MM-DD), subject, notes, channel (telephone, sms, email).managedPATCH /relances/{id}Updates a follow-up; { status: "done" } marks it done.managedDELETE /relances/{id}Deletes a follow-up.managedGET /accounting/settingsAccounting settings (on/off, VAT status…), the professional's invoicing profile (SIRET, legal form, address…) and the mentions still missing.accountingPATCH /accounting/settingsTurns Accounting on ({ enabled: true }) and/or updates its settings and the invoicing profile.accountingGET /accounting/quotesQuotes (latest 300); ?contactId=, ?status=draft|sent|accepted|refused|cancelled|expired.accountingPOST /accounting/quotesNew draft quote: contactId, title, client, lines, notes.accountingGET /accounting/quotes/{id}A quote (status, totals, online-acceptance link once sent).accountingPATCH /accounting/quotes/{id}Updates a draft (missing fields are kept).accountingDELETE /accounting/quotes/{id}Deletes a draft.accountingPOST /accounting/quotes/{id}/sendSends: mentions checked, number, document frozen, email to the client.accountingPOST /accounting/quotes/{id}/resendResends a sent quote's email.accountingPOST /accounting/quotes/{id}/cancelCancels a sent or accepted quote.accountingPOST /accounting/quotes/{id}/duplicateCopies a quote into a new draft (to “edit” a sent quote).accountingGET /accounting/quotes/{id}/pdfThe quote's PDF (preview without a number for a draft).accountingGET /accounting/invoicesInvoices and credit notes (latest 300); ?contactId=, ?kind=invoice|credit_note, ?status=draft|issued.accountingPOST /accounting/invoicesNew draft invoice: the draft itself, { fromQuoteId } or { fromAppointmentId }.accountingGET /accounting/invoices/{id}An invoice or credit note; an issued invoice carries what remains to cancel.accountingPATCH /accounting/invoices/{id}Updates a draft invoice or credit note (including paymentMethod, VAT-exempt professionals).accountingDELETE /accounting/invoices/{id}Deletes a draft (an issued document is never deleted).accountingPOST /accounting/invoices/{id}/issueIssues: gap-free number, document frozen; { sendEmail } (defaults to the invoiceEmail setting).accountingPOST /accounting/invoices/{id}/resendResends an issued document's email.accountingPOST /accounting/invoices/{id}/duplicateCopies an invoice into a new draft.accountingPOST /accounting/invoices/{id}/credit-notesOpens a credit note on an issued invoice, prefilled (in full or what remains).accountingGET /accounting/invoices/{id}/pdfThe invoice's or credit note's PDF.accountingGET /accounting/other-salesOther sales of a period (?period=, current period by default).accountingPOST /accounting/other-salesAdds an other sale: saleDate, category, amountTtcCents, vatRate, operationsCount, note.accountingPATCH /accounting/other-sales/{id}Replaces an other sale.accountingDELETE /accounting/other-sales/{id}Deletes an other sale.accountingGET /accounting/periodsLatest periods to report (?count=1 to 24): totals, deadline, declaration, gap.accountingGET /accounting/periods/{key}One period: totals per day, category and rate, other sales, declaration, XML file.accountingPOST /accounting/periods/{key}/declarationMarks the period as reported (next version when correcting).accountingDELETE /accounting/periods/{key}/declarationRemoves the latest reported version.accountingGET /accounting/periods/{key}/csvThe period's sales as CSV.accountingGET /accounting/periods/{key}/xmlThe period's official “flux 10” file, for the approved platform.accountingGET /accounting/exportA year's ZIP archive (?year=): invoice and credit note PDFs + register.accounting
GET /business
{
"data": {
"name": "Atelier Coiffure",
"slug": "atelier-coiffure",
"city": "Quimper",
"timezone": "Europe/Paris",
"currency": "EUR",
"bookingUrl": "https://daytio.com/atelier-coiffure",
"bookingOpen": true,
…
}
}GET /availability?services=3f0c…&from=2026-10-12&days=7
{
"data": {
"timezone": "Europe/Paris",
"durationMinutes": 45,
"groupClass": false,
"days": [
{
"date": "2026-10-12",
"slots": [
{ "startsAt": "2026-10-12T07:00:00.000Z", "time": "09:00" },
{ "startsAt": "2026-10-12T07:45:00.000Z", "time": "09:45" }
]
}
]
}
}Booking
The client's consent (consent: true) is mandatory: show an UNCHECKED box “I agree that my data is used to manage my appointment”. marketingConsent is a second, optional and separate box.
POST /bookings
{
"services": ["3f0c…"],
"startsAt": "2026-10-12T07:00:00.000Z",
"client": {
"firstName": "Camille",
"lastName": "Martin",
"email": "camille@example.com",
"phone": "0612345678"
},
"consent": true,
"returnUrl": "https://www.mon-salon.fr/reservation/merci"
}- Appointment created (201). The client and the professional get their confirmation email; the client finds their link to reschedule or cancel in it. manageUrl (that same link) is only returned to a professional's key with no website declared: it opens the client's space, so it is never handed to a public, developer or partner key (null).
- The service requires online payment (200): redirect the client to checkoutUrl. Nothing is booked until they pay.
- Always handle refusal: a displayed slot may be taken in the meantime (409 booking_failed). Offer to pick another one.
// 201 — rendez-vous créé / appointment created
{ "data": { "status": "confirmed", "startsAt": "…", "endsAt": "…",
"partySize": 1, "manageUrl": null } }
// 200 — paiement en ligne exigé / online payment required
{ "data": { "status": "payment_required",
"checkoutUrl": "https://checkout.stripe.com/…" } }
// 409
{ "error": { "code": "booking_failed", "message": "…" } }Online payment
Pass returnUrl (and cancelUrl if needed), on a website declared on the key. After paying, the client returns to returnUrl with ?daytio_session=…; poll /payments/{id} until confirmed (a few seconds). Without returnUrl, the client ends on Daytio's confirmation page.
Statuses: confirmed (paid, booked), processing (paid, confirmation in progress), awaiting_payment, expired (abandoned), failed (slot taken meanwhile: refunded).
GET /payments/cs_live_…
{ "data": { "status": "confirmed", "startsAt": "…",
"amountPaid": 30, "currency": "EUR" } }Client records (professional only)
To connect the professional's own software (till, CRM, spreadsheet) to their client records, with THEIR key. A developer key NEVER has access (403 module_not_enabled); a partner only gets in through “Sign in with Daytio”, and only to the records created on their website — except on the accounts they created themselves, once validated by Daytio (see “Partner platform”). Personal data: call these routes from a server only. Statuses: prospect, client, lost. The name field is the name as entered (often the full name): don't split it. The email identifies a client: two records cannot share it.
GET /clients?q=martin&limit=20
{ "data": { "clients": [
{ "id": "5d2a…", "firstName": "Camille", "name": "Camille Martin",
"email": "camille@example.com", "phone": "0612345678",
"status": "client", "marketingConsent": false, … }
], "hasMore": false, "limit": 20, "offset": 0 } }
POST /clients
{ "name": "Camille Martin", "email": "camille@example.com", "phone": "0612345678" }
PATCH /clients/5d2a…
{ "notes": "Préfère le samedi", "status": "client" }
GET /clients/5d2a…/appointments?from=2026-01-01T00:00:00Z
{ "data": { "appointments": [
{ "id": "…", "title": "Coupe femme", "status": "confirmed",
"startsAt": "…", "endsAt": "…", "priceTotal": 45, "staffName": "Léa" }
] } }Partners: create a professional's account
The professional doesn't have a Daytio account yet? With your partner key (dtp_live_…, created in 2 minutes above), create it yourself. They receive an email to choose their password — you never know their credentials. The account's API access is active straight away and billed to you by bank transfer. Until Daytio has validated your partner account: booking only, 5 accounts a day; once validated, full access to the accounts you create (see “Partner platform”).
POST /accounts
Authorization: Bearer dtp_live_…
{
"businessName": "Atelier Coiffure",
"owner": { "firstName": "Camille", "lastName": "Martin",
"email": "camille@atelier-coiffure.fr", "phone": "0612345678" },
"country": "FR",
"category": "Coiffure",
"city": "Quimper",
// Facultatif : son espace est sur votre site / optional: their space is on your website
"spaceUrl": "https://votre-site.fr/espace-pro",
"bookingPage": false,
// Facultatif : profil de facturation / optional: invoicing profile
"invoicing": { "siret": "123 456 782 00010", "legalForm": "EI",
"address": "12 rue de Brest", "postalCode": "29000",
"city": "Quimper", "vatRegime": "franchise" }
}
// 201
{ "data": { "id": "9b1e…", "slug": "atelier-coiffure",
"bookingUrl": "https://daytio.com/atelier-coiffure",
"status": "active",
"modules": ["reservation", "clients_read", "clients_write", "client_history", "accounting"],
"space": "partner", "bookingPage": false,
"welcomeEmailSent": true, "passwordEmailSent": false,
"accounting": { "enabled": true, "missingMentions": [] } } }
// Ensuite / then
GET /services
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…Everything on your website: with spaceUrl (a sign-in address on one of your declared websites, validated partner), the welcome email sends the professional to YOUR website, with no Daytio password or daytio.com link — they only manage their account with you. With bookingPage: false, their daytio.com page no longer offers booking: their clients book on your website (POST /bookings). Without these options, the professional gets the usual Daytio email and keeps their page. Each account follows its own choice; bookingPage can be changed later with PATCH /business.
To act on that account afterwards (services, slots, bookings), call the other routes with your partner key and the header Daytio-Account: <returned id>. A professional who already has an account (409 account_exists) sends you a “developer” key themselves, or authorizes you with “Sign in with Daytio”.
Partner platform: manage the accounts you create
Your professionals work on YOUR platform and you administer their accounts? On an account you created (POST /accounts), your partner key has full access: profile, logo, booking link, services, calendar, client records (all of them), revenue, follow-ups and Accounting — with the Daytio-Account header, like everything else. These accounts are on a complimentary Pro plan (you pay for the access), with Accounting turned on: send the professional's invoicing profile (SIRET, legal form, address, VAT) when you create the account (invoicing) or with PATCH /accounting/settings.
- Reserved for partners VALIDATED by Daytio (write to us). Self-registered, your key only has booking; once validated, the accounts you already created get full access. An account that is only linked: profile, services, revenue and the website's appointments with the professional's token (see “Manage a linked professional's account”) — never their whole clientele nor their follow-ups.
- The professional is told as soon as their account is created (welcome email): you manage their account with full access. These accounts' API access is billed to you by bank transfer; if unpaid, it is suspended (403 api_access_inactive) — and the professional's dashboard with it.
- Follow-ups: Daytio sends NO email on these accounts, neither to the professional's clients nor to the professional. Read them (GET /relances?dueBefore=<today>) and show them as notifications on your platform; { status: "done" } clears them.
- Still in the Daytio dashboard: opening hours, time off, group classes (sessions, seats), a service's advanced settings, country and time zone, online payment (Stripe).
// Toutes ces routes : clé partenaire + compte créé par vous
// All these routes: partner key + an account you created
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…
PATCH /business
{ "description": "Photographe de mariage à Nantes", "phone": "0612345678",
"brandColor": "#8E684E", "slug": "camille-photo" }
POST /services
{ "name": "Reportage mariage", "durationMinutes": 480, "price": 1200 }
PATCH /services/4d2a…
{ "active": false }
GET /stats?granularity=week&from=2026-09-01&to=2026-10-16
// 200 — granularity : day, week ou month (par défaut)
{ "data": { "currency": "EUR", "timezone": "Europe/Paris", "granularity": "week",
"from": "2026-08-31", "to": "2026-10-18",
"periods": [ { "period": "2026-10-12", "from": "2026-10-12", "to": "2026-10-18",
"revenue": 640, "appointments": 4, "cancelled": 0 }, … ],
"totals": { "revenue": 4150, "appointments": 27, "cancelled": 2 },
"clients": { "total": 48, "newInPeriod": 9 } } }
GET /stats/summary
// 200 — l'accueil du tableau de bord / the dashboard home
{ "data": { "today": "2026-10-16",
"revenue": { "today": { "revenue": 120, "appointments": 2, … },
"thisWeek": { "revenue": 640, … }, "thisMonth": { "revenue": 2450, … } },
"appointments": { "today": 2, "upcoming": 14 }, "clients": { "total": 48 },
"cancellation": { "days": 30, "rate": 7, "cancelled": 1, "created": 14 } } }
GET /relances?dueBefore=2026-10-15
// 200 — à afficher en notifications / show as notifications
{ "data": { "relances": [ { "id": "…", "status": "todo", "due": "overdue",
"dueOn": "2026-10-12", "subject": "Devis album",
"client": { "name": "Léa Moreau", "phone": "…" } } ],
"hasMore": false } }
PATCH /relances/…
{ "status": "done", "notes": "Rappelée, devis envoyé." }Accounting: quotes, invoices, sales to report
Everything Daytio's Accounting screen does, through the API (“accounting” function): settings, quotes sent and accepted online, invoices to individuals and credit notes, other sales, sales to report with their official file, yearly export. Each route calls the same operation as the screen: same checks, same numbers, same documents.
- Reserved for the professional themselves (their key, created “for me”) and for accounts that a VALIDATED partner platform created. Never a developer key, never an account only linked through “Sign in with Daytio”: invoices carry clients' names and addresses. Always from a server.
- Pro plan or higher, professional based in France (403 accounting_unavailable otherwise). Accounting must be TURNED ON: PATCH /accounting/settings { "enabled": true } (403 accounting_disabled until then — only settings, PDFs and the export stay open). An account created by a validated platform is on Pro from the start, with Accounting turned on.
- Invoicing profile: what the professional fills in on your website and what is printed on their quotes and invoices — siret, legalForm, address, addressComplement, postalCode, city, email, phone, tradeRegister, documentsDisplayName, vatRegime, vatNumber. Read and update it with GET/PATCH /accounting/settings (missingMentions says what is still missing), or send it as soon as the account is created (invoicing field of POST /accounts, same names). Address, email, phone, SIRET and legal form are also those of PATCH /business: changing one changes the other. SIRET checked (14 digits, spaces allowed, valid check digit).
- Values: vatRegime is "franchise" (VAT exemption scheme) or "assujetti" (“I charge VAT” — never "reel"); with "assujetti", vatNumber is required (e.g. FR12345678901) and vatFiling is "simplifie", "reel_mensuel" or "reel_trimestriel". missingMentions → fields to complete: seller_siret = siret; seller_address = address + postalCode + city; seller_vat_number = vatNumber. Numbering is assigned by Daytio when a quote is sent or an invoice issued, gapless and per year: D-2026-0001 (quotes), F-2026-0001 (invoices), A-2026-0001 (credit notes).
- A document starts as a DRAFT (editable with PATCH), then is sent (quote) or issued (invoice, credit note): gap-free number assigned by Daytio, content frozen (409 document_locked afterwards). Edit a sent quote by duplicating it; correct an invoice with a credit note. Missing mandatory mentions are listed (422 missing_mentions).
- Amounts in euro CENTS. VAT-exempt: unitPriceCents is the price paid and vatRate is 0; if the professional charges VAT, unitPriceCents EXCLUDES tax and vatRate is one of 0, 2.1, 5.5, 10 and 20. category: services or goods. Invoices to individuals only (422 b2c_only).
- Automatic drafts: every morning, Daytio prepares a draft invoice for each paid appointment that ended the day before — when first turned on (enabled: true), those of the last 15 days, prepared right away (sourceAppointmentId set) — never issued: list them with ?status=draft, then issue or delete them (no-show). Setting autoInvoiceDrafts (true by default). Payment method: paymentMethod = card, cash, transfer or cheque, for a VAT-exempt professional only (422 payment_method_unavailable otherwise); paidOnlineCents (read-only) carries the deposit paid online when booking; settled marks an issued invoice as paid in full. Sending by email: setting invoiceEmail (false by default) — while it is false, no invoice or credit note is emailed to the client (sendEmail is ignored and email.error says so; resend answers 422 invoice_email_disabled): fetch the PDF instead.
- Sales to report: Daytio computes daily totals (no client data) and produces the official XML file; Daytio sends NOTHING to the tax authority — the professional files it with their approved platform, then marks the period as reported. A late invoice creates a gap: the file becomes a corrective one, to be reported again.
// Clé du professionnel (pour lui-même), ou clé partenaire + Daytio-Account
// The professional's own key, or a partner key + Daytio-Account
Authorization: Bearer dtk_live_…
GET /accounting/settings
// 200 { "data": { "enabled": false, "vatRegime": "franchise", "siret": "", …,
// "missingMentions": ["seller_siret", "seller_address"] } }
PATCH /accounting/settings
{ "enabled": true, "vatRegime": "franchise", "quoteValidityDays": 30,
// ou / or "vatRegime": "assujetti", "vatNumber": "FR12123456782", "vatFiling": "reel_mensuel"
"siret": "123 456 782 00010", "legalForm": "EI",
"address": "12 rue de Brest", "postalCode": "29000", "city": "Quimper" }
// 200 { "data": { "enabled": true, …, "missingMentions": [] } }
POST /accounting/quotes
{ "contactId": "5c1e…", "title": "Mariage — 14 juin",
"client": { "name": "Jean-Pierre Le Roy", "email": "jp@exemple.fr",
"address": "3 place Saint-Corentin, 29000 Quimper" },
"lines": [ { "label": "Coiffure mariée", "quantity": 1,
"unitPriceCents": 12000, "vatRate": 0, "category": "services" } ] }
// 201 { "data": { "id": "a71f…", "status": "draft", "number": null, … } }
POST /accounting/quotes/a71f…/send
// 200 { "data": { "status": "sent", "number": "D-2026-0007",
// "publicUrl": "https://daytio.com/devis/…", "email": { "sent": true } } }
// 422 { "error": { "code": "missing_mentions", "missing": ["seller_siret"] } }
POST /accounting/invoices
{ "fromQuoteId": "a71f…" } // ou / or { "fromAppointmentId": "…" }
PATCH /accounting/invoices/c903…
{ "serviceDate": "2026-06-14", "servicePlace": "Manoir de Kerazan, Loctudy" }
POST /accounting/invoices/c903…/issue
{ "sendEmail": true }
// 200 { "data": { "status": "issued", "number": "F-2026-0012", … } }
POST /accounting/invoices/c903…/credit-notes // avoir pré-rempli / prefilled credit note
GET /accounting/periods?count=6
POST /accounting/periods/2026-B5/declaration
GET /accounting/periods/2026-B5/xml // fichier « flux 10 » / official fileLink a professional's account
So that a professional links their Daytio account to your website — without ever giving you their password or a key — and you can book for them and manage your visitors' records. Free: it's included in their plan (Essential or above). Two ways, giving the same token.
With a code received by email (simplest)
- 1. On your website, the professional types their Daytio address. Your server calls POST /auth/code { email } with your partner key. Daytio sends a 6-digit code to that address, valid for 1 hour, naming your company. The response (202) is the same whether the address has an account or not.
- 2. The professional types the code on your website. Your server calls POST /auth/token { email, code }: you get the account id (accountId) and a 12-hour token. 5 attempts per code; beyond that, request another one. A professional can receive 3 per hour.
- 3. When the token expires (401 session_expired), request a new code. Your website stays linked: only the token needs renewing.
// 1. Le pro tape son adresse / the professional types their address
POST /auth/code
Authorization: Bearer dtp_live_…
{ "email": "camille@atelier-coiffure.fr" }
// 202 — même réponse si l'adresse est inconnue / same response if unknown
{ "data": { "status": "sent", "expiresInMinutes": 60, "message": "…" } }
// 2. Il tape le code reçu / they type the code they received
POST /auth/token
Authorization: Bearer dtp_live_…
{ "email": "camille@atelier-coiffure.fr", "code": "482913" }
// 200
{ "data": { "token": "dts_live_…", "expiresAt": "2026-10-15T08:00:00Z",
"accountId": "9b1e…", "businessName": "Atelier Coiffure",
"user": { "email": "camille@atelier-coiffure.fr", "name": "Camille Martin" },
"scopes": ["clients_read", "clients_write", "client_history"] } }
// 3. Réserver pour vos visiteurs / book for your visitors
POST /bookings
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…
// 4. Fiches créées sur votre site / records created on your website
GET /clients
Authorization: Bearer dts_live_…With “Sign in with Daytio” (redirect)
The professional signs in ON daytio.com, sees what your website asks for and clicks “Allow”; your server receives a code and exchanges it for the same token. Declare your return address first: PATCH /partner { sites }.
- 1. Send the professional to https://daytio.com/connexion-partenaire with client_id (your partner identifier), redirect_uri (a return address on one of your declared websites), state (a random value kept in their session) and response_type=code.
- 2. On return, check state, then exchange the code from your server: POST /auth/token with your partner key and the SAME redirect_uri. The code is valid for 5 minutes, once. If the professional declines, they come back with error=access_denied.
- 3. The token (dts_live_…) is used like a key on the /clients routes and to manage the account (below), from your server. When it expires (401 session_expired), send the professional back to daytio.com: if they already authorized your website and are signed in, they come straight back without clicking anything. DELETE /auth/token signs them out.
// 1. Lien « Se connecter avec Daytio » / "Sign in with Daytio" link
https://daytio.com/connexion-partenaire?client_id=<id partenaire / partner id>
&redirect_uri=https%3A%2F%2Fwww.atelier-coiffure.fr%2Fdaytio%2Fretour
&state=<aléatoire / random>&response_type=code
// 2. Retour / back: …/daytio/retour?code=dtc_…&state=…
POST /auth/token
Authorization: Bearer dtp_live_…
{ "code": "dtc_…", "redirectUri": "https://www.atelier-coiffure.fr/daytio/retour" }
// 200
{ "data": { "token": "dts_live_…", "expiresAt": "2026-10-15T08:00:00Z",
"accountId": "9b1e…", "businessName": "Atelier Coiffure",
"user": { "email": "camille@atelier-coiffure.fr", "name": "Camille Martin" },
"scopes": ["clients_read", "clients_write", "client_history"] } }
// 3. Fiches créées sur votre site / records created on your website
GET /clients
Authorization: Bearer dts_live_…⚠️ The token ONLY sees what was done on your website: the records you created (POST /clients) or that were born from a booking made on your website, and those appointments. The clientele the professional already had in Daytio stays invisible — an email that is already known returns 409 client_exists, with no identifier. To book (GET /availability, POST /bookings), use the same token — or your partner key with the header Daytio-Account: <returned accountId>, which also works when the professional is not signed in.
The professional can remove access at any time (Settings → Website): your tokens stop working at once. Prerequisite: an Essential plan or above (not Daytio Mini, not the Restaurant plan) — otherwise the professional gets an email explaining it, and no code.
Manage a linked professional's account
With the professional's session token (dts_live_…), your website also manages their account, as they would in Daytio: profile and logo (GET/PATCH /business, /business/logo), services (GET /services?status=all, POST, PATCH, DELETE /services), team (GET /staff), slots and bookings in their calendar (GET /availability, POST /bookings, GET /payments/{id}), revenue (GET /stats, GET /stats/summary) and calendar (GET /appointments) — limited to the appointments booked on your website. Revenue is totals only: no client appears in it. Always from your server.
It is the signed-in professional who opens their account: your partner key alone is not enough (403 session_required). Follow-ups and the clientele the professional already had remain reserved for the accounts you created.
// Jeton du pro relié / the linked professional's token
Authorization: Bearer dts_live_…
GET /stats/summary
GET /stats?granularity=day
GET /services?status=all
PATCH /services/4d2a…
{ "price": 45 }
GET /appointments?from=2026-10-01&to=2026-10-31
// seulement les RDV pris sur votre site / only those booked on your websiteError codes
missing_api_keyNo key in the request.invalid_api_keyUnknown or revoked key.origin_not_allowedBrowser call from a website not declared on the key.rate_limitedToo many requests. Try again later.account_unavailableThe professional's account is deactivated.invalid_requestMissing or invalid parameter (the message says which).not_foundResource not found.booking_failedBooking refused (slot taken, notice period, missing phone…).return_url_not_allowedreturnUrl / cancelUrl outside the declared websites.unsupported_accountRestaurant account (use the widget or the link), or a plan without API (Daytio Mini).api_access_inactivePartner account suspended, or the professional's full API not opened yet / suspended (payment).module_not_enabledFunction not opened for this key or account — client records never open to a developer.server_side_onlyClient-records or partner key used from a browser.account_requiredPartner key without the Daytio-Account header.partner_onlyRoute reserved for partner keys (dtp_live_…).account_existsThis professional already has a Daytio account: they send you a key.client_existsA record already uses this email (clientId provided, unless it was not created on your website).invalid_grantInvalid, expired or already used code (email code: 1 h, 5 attempts; redirect code: 5 min), or a different redirect_uri.session_expiredToken expired, or access removed by the professional: request a new code (or sign them in again with Daytio).managed_account_onlyFollow-ups: reserved for the accounts you created (POST /accounts), with a partner account validated by Daytio.session_requiredAccount management: call the route with the professional's session token (POST /auth/token), or on an account you created with a validated partner account.accounting_unavailableAccounting: Pro plan (or higher) only, for a professional based in France.accounting_disabledAccounting is not turned on for this account: PATCH /accounting/settings { "enabled": true }, or Settings → Accounting.document_lockedDocument already sent or issued: it is frozen. Duplicate a quote; correct an invoice with a credit note.invalid_stateNot possible in the current state (quote not accepted, appointment cancelled, invoice already fully credited…). The message says which.missing_mentionsMandatory mentions missing to send or issue: the list is in “missing” (SIRET, address, VAT number, client…).b2c_onlyDaytio only invoices individuals (not businesses).credit_note_invalidCredit note refused: empty, rate not on the invoice, or more than what remains to cancel (details in “creditProblems”).period_openThe period has not ended: it can be reported (and its XML file produced) the day after it ends.period_declaredDay in a period marked as reported: remove the declaration (DELETE …/declaration) to change its other sales.already_declaredPeriod already reported, and nothing has changed since.file_unavailableFile not available: SIRET missing or invalid, no sales, or a rate refused by the tax authority (reason in “reason”).payment_method_unavailablePayment method refused: it is only offered to businesses exempt from VAT (franchise en base) — a business that charges VAT would otherwise need certified point-of-sale software.invoice_email_disabledSending by email is off: the professional has not turned on the invoiceEmail setting (Settings → Accounting). Fetch the PDF, or turn the setting on.requests_disabledRequests: the “Requests” module is not turned on for this account (on request to Daytio). Nothing was saved.server_errorError on our side: try again. Nothing was half-saved.
Full example (JavaScript)
const API = "https://daytio.com/api/v1";
const KEY = "dtk_live_…"; // de préférence côté serveur / server-side if possible
async function daytio(path, init = {}) {
const res = await fetch(API + path, {
...init,
headers: {
Authorization: "Bearer " + KEY,
"Content-Type": "application/json",
...init.headers,
},
});
const json = await res.json();
if (json.error) throw Object.assign(new Error(json.error.message), json.error);
return json.data;
}
// 1. Prestations / services
const services = await daytio("/services");
// 2. Créneaux libres sur 7 jours / free slots over 7 days
const today = new Date().toISOString().slice(0, 10);
const { days } = await daytio(
"/availability?services=" + services[0].id + "&from=" + today + "&days=7",
);
// 3. Réserver le premier créneau / book the first slot
const slot = days.find((d) => d.slots.length)?.slots[0];
try {
const booking = await daytio("/bookings", {
method: "POST",
body: JSON.stringify({
services: [services[0].id],
startsAt: slot.startsAt,
client: { firstName: "Camille", lastName: "Martin", email: "camille@example.com" },
consent: true, // case cochée par le client / box ticked by the client
returnUrl: location.origin + "/reservation/merci",
}),
});
if (booking.status === "payment_required") {
location.href = booking.checkoutUrl; // Stripe, puis retour / then back
} else {
showConfirmation(booking); // booking.startsAt (lien de gestion : par e-mail / sent by email)
}
} catch (e) {
if (e.code === "booking_failed") askForAnotherSlot(e.message);
else throw e;
}
// 4. Page /reservation/merci : état du paiement / payment status
const session = new URLSearchParams(location.search).get("daytio_session");
if (session) {
const payment = await daytio("/payments/" + encodeURIComponent(session));
// payment.status : confirmed | processing | awaiting_payment | expired | failed
}Restaurant accounts: the API covers appointments and classes. For tables and takeaway, use the widget or the link.
The professional's full API
To connect the professional's own software (till, CRM) to their WHOLE clientele, with their own key. €25/month per business, every function included. Billed monthly by bank transfer: we send you our bank details, access opens once the transfer is received. Building a professional's website? No need: your developer key (above) is enough, and it's free.
Questions?
Write to us, with the name of the business concerned. daytio.com/en/contact
