API REST v1

API REST de lecture/écriture : clientèle, contacts, notes, rapports de visite, rendez-vous, opportunités, tournées, étiquettes et données publiques d'entreprises. Authentification : `Authorization: Bearer <clé>` (clés créées dans Paramètres → API, droits lecture ou lecture+écriture).

Authentification

curl https://tourneo-gamma.vercel.app/api/v1/companies?limit=10 \
  -H "Authorization: Bearer tk_…"

Écriture

curl -X POST https://tourneo-gamma.vercel.app/api/v1/appointments \
  -H "Authorization: Bearer tk_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"RDV","starts_at":"2026-11-03T09:00:00+01:00","ends_at":"2026-11-03T09:45:00+01:00"}'

• Pagination : limit (≤ 200) et offset
• Tri : order=colonne.asc|desc
• Création en lot : tableau de 100 objets max
• Erreurs : { error: { message, status, details } }
• Droits : lecture (GET) / écriture (POST, PATCH, DELETE)
• CORS ouvert, JSON UTF-8, dates ISO 8601

companies

get/api/v1/companiesLister — Établissements de la clientèle (CRM)

Lister — Établissements de la clientèle (CRM)

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, name, enseigne, siret, city, postal_code, category, priority, potential, owner_id, status_tag_id, next_action_at, last_visit_at, created_at, updated_at
q	query	Recherche dans name, enseigne, city, siret
status_tag_id	query	Statut commercial (id d'étiquette)
category	query	Type de magasin (boulangerie, fleuriste…)
siret	query	SIRET exact
city	query	Ville
owner_id	query	Commercial
updated_since	query	Modifiés depuis (ISO 8601)

post/api/v1/companiesCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/companies/{id}Lire

Lire

patch/api/v1/companies/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/companies/{id}Supprimer

Supprimer

Droit d'écriture requis

contacts

get/api/v1/contactsLister — Interlocuteurs

Lister — Interlocuteurs

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, first_name, last_name, email, company_id, is_primary, created_at
q	query	Recherche dans first_name, last_name, email
company_id	query	Établissement

post/api/v1/contactsCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/contacts/{id}Lire

Lire

patch/api/v1/contacts/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/contacts/{id}Supprimer

Supprimer

Droit d'écriture requis

notes

get/api/v1/notesLister — Notes

Lister — Notes

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, company_id, author_id, kind, pinned, created_at, updated_at
q	query	Recherche dans body
company_id	query	Établissement
kind	query	note \| appel \| email \| reunion \| interne

post/api/v1/notesCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/notes/{id}Lire

Lire

patch/api/v1/notes/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/notes/{id}Supprimer

Supprimer

Droit d'écriture requis

reports

get/api/v1/reportsLister — Rapports de visite, prospection, rendez-vous, appel ou tournée

Lister — Rapports de visite, prospection, rendez-vous, appel ou tournée

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, company_id, tour_id, author_id, kind, outcome, interest, visited_at, next_action_at, order_amount, quote_amount, created_at, updated_at
q	query	Recherche dans title, summary, needs, objections, competitors, next_step, contact_name
company_id	query	Établissement
tour_id	query	Tournée
appointment_id	query	Rendez-vous
author_id	query	Auteur (commercial)
kind	query	visite \| prospection \| rendez_vous \| appel \| tournee \| autre
outcome	query	positif \| neutre \| negatif \| sans_suite
from	query	Date de visite ≥ (ISO 8601)
to	query	Date de visite ≤ (ISO 8601)
follow_up_before	query	Relance prévue avant (ISO 8601)
updated_since	query	Modifiés depuis (ISO 8601)

post/api/v1/reportsCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/reports/{id}Lire

Lire

patch/api/v1/reports/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/reports/{id}Supprimer

Supprimer

Droit d'écriture requis

appointments

get/api/v1/appointmentsLister — Rendez-vous

Lister — Rendez-vous

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, title, starts_at, ends_at, status, owner_id, company_id, created_at, updated_at
q	query	Recherche dans title, location
from	query	Début après (ISO 8601)
to	query	Début avant (ISO 8601)
owner_id	query	Commercial
company_id	query	Établissement
status	query	planifie \| confirme \| realise \| annule

post/api/v1/appointmentsCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/appointments/{id}Lire

Lire

patch/api/v1/appointments/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/appointments/{id}Supprimer

Supprimer

Droit d'écriture requis

opportunities

get/api/v1/opportunitiesLister — Opportunités commerciales

Lister — Opportunités commerciales

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, title, amount, probability, expected_close_date, stage_id, owner_id, company_id, position, closed_at, created_at, updated_at
q	query	Recherche dans title
stage_id	query	Étape
company_id	query	Établissement
owner_id	query	Commercial

post/api/v1/opportunitiesCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/opportunities/{id}Lire

Lire

patch/api/v1/opportunities/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/opportunities/{id}Supprimer

Supprimer

Droit d'écriture requis

tours

get/api/v1/toursLister — Tournées commerciales

Lister — Tournées commerciales

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, name, date, status, owner_id, start_time, total_distance_m, total_duration_s, created_at, updated_at
q	query	Recherche dans name
from	query	Date ≥ (AAAA-MM-JJ)
to	query	Date ≤
owner_id	query	Commercial
status	query	Statut

post/api/v1/toursCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/tours/{id}Lire

Lire

patch/api/v1/tours/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/tours/{id}Supprimer

Supprimer

Droit d'écriture requis

post/api/v1/tours/{id}/optimizeOptimiser une tournée (ordre, horaires, itinéraire)

Optimiser une tournée (ordre, horaires, itinéraire)

Droit d'écriture requis

path

get/api/v1/tours/{id}/icsCalendrier iCalendar de la tournée

Calendrier iCalendar de la tournée

path

tour stops

get/api/v1/tour_stopsLister — Arrêts de tournée

Lister — Arrêts de tournée

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, tour_id, position, status, priority, eta, etd, visited_at, label, created_at
tour_id	query	Tournée
status	query	a_faire \| visite \| absent \| reporte

post/api/v1/tour_stopsCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/tour_stops/{id}Lire

Lire

patch/api/v1/tour_stops/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/tour_stops/{id}Supprimer

Supprimer

Droit d'écriture requis

pipeline stages

get/api/v1/pipeline_stagesLister — Étapes du pipeline

Lister — Étapes du pipeline

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, name, position, probability

post/api/v1/pipeline_stagesCréer (objet ou tableau de 100 max)

Créer (objet ou tableau de 100 max)

Droit d'écriture requis

get/api/v1/pipeline_stages/{id}Lire

Lire

patch/api/v1/pipeline_stages/{id}Modifier

Modifier

Droit d'écriture requis

delete/api/v1/pipeline_stages/{id}Supprimer

Supprimer

Droit d'écriture requis

activities

get/api/v1/activitiesLister — Journal d'activité (lecture seule)

Lister — Journal d'activité (lecture seule)

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, type, company_id, user_id, created_at
company_id	query	Établissement
type	query	Type
since	query	Depuis (ISO 8601)

get/api/v1/activities/{id}Lire

Lire

users

get/api/v1/usersLister — Utilisateurs de l'organisation (lecture seule)

Lister — Utilisateurs de l'organisation (lecture seule)

limit	query
offset	query
order	query	colonne.asc\|desc — colonnes : id, email, full_name, role, created_at
role	query	admin \| manager \| commercial

get/api/v1/users/{id}Lire

Lire

données publiques

get/api/v1/etablissementsRechercher des établissements (SIRENE) par texte ou par zone

Rechercher des établissements (SIRENE) par texte ou par zone

q	query
lat	query
lng	query
radius_km	query
categories	query	Codes séparés par des virgules (voir /api/v1/categories)

get/api/v1/etablissements/{siret}Fiche entreprise complète : identité, dirigeants, finances, BODACC

Fiche entreprise complète : identité, dirigeants, finances, BODACC

siret

path

get/api/v1/categoriesTypes de magasins et codes NAF associés

Types de magasins et codes NAF associés

API REST v1

companies

contacts

notes

reports

appointments

opportunities

tours

tour stops

tags

pipeline stages

activities

users

données publiques