Orvlabs

221

Données de référence, outils et paiements pour les développeurs au Sénégal. Premiers pas : 1. Créer un projet dans le tableau de bord. 2. Créer une clé API…

Data & analytics#open-data

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Données de référence, outils et paiements pour les développeurs au Sénégal.

Premiers pas :

  1. Créer un projet dans le tableau de bord.
  2. Créer une clé API dans ce projet (sk_221_pay_test_…) et la copier : elle n'est affichée qu'une fois.
  3. Vérifier la clé : GET /v1/categories avec l'en-tête Authorization: Bearer sk_221_pay_test_…
  4. Créer un paiement : POST /v1/payments avec le même en-tête et un en-tête Idempotency-Key, unique pour chaque paiement (un renvoi avec la même valeur ne crée pas de doublon).

Les routes de données fonctionnent aussi sans clé, avec un quota bas par adresse IP.

Endpoints 140

adresses

  • GETGéocoder une adresse descriptive au lieu connu le plus fin/v1/adresses/geocoder?texte=En face de la pharmacie, Médina, Dakar
  • GETDécomposer une adresse descriptive : relation, repère et lieu connu/v1/adresses/normaliser?texte=En face de la pharmacie, Médina, Dakar
  • GETSuggestions à la saisie : régions, départements, arrondissements, communes et localités/v1/adresses/suggestions?q=thies

annuaire

  • GETAnnuaire des API et SDK/v1/annuaire
  • GETAnnuaire des API et SDK : une fiche/v1/annuaire/:id

payments

  • GETautoPayoutGet/v1/auto-payout
  • PUTautoPayoutSet/v1/auto-payout
  • GETbalancesGet/v1/balances
  • GETcustomersList/v1/customers
  • GETcustomersGet/v1/customers/:id
  • GETdisputesList/v1/disputes
  • POSTdisputesCreate/v1/disputes
  • GETdisputesGet/v1/disputes/:id
  • POSTdisputesAccept/v1/disputes/:id/accept
  • PUTdisputesEvidenceUpload/v1/disputes/:id/evidence
  • POSTdisputesChallenge/v1/disputes/:id/evidence
  • GETfeesGet/v1/fees
  • GETkycDocuments/v1/kyc/documents
  • POSTkycSessionsCreate/v1/kyc/sessions
  • POSTkycSessionsUploads/v1/kyc/sessions/uploads
  • GETkycStatus/v1/kyc/status
  • POSTkycSubmit/v1/kyc/submit
  • GEToffersList/v1/offers
  • POSToffersCreate/v1/offers
  • GEToffersGet/v1/offers/:id
  • DELETEoffersDelete/v1/offers/:id
  • POSToffersStatus/v1/offers/:id/status
  • GETpaymentLinkBatchesList/v1/payment-link-batches
  • POSTpaymentLinkBatchesCreate/v1/payment-link-batches
  • GETpaymentLinkBatchesGet/v1/payment-link-batches/:id
  • POSTpaymentLinkBatchesDuplicate/v1/payment-link-batches/:id/duplicate
  • GETpaymentLinksList/v1/payment-links
  • POSTpaymentLinksCreate/v1/payment-links
  • GETpaymentLinksGet/v1/payment-links/:id
  • POSTpaymentLinksStatus/v1/payment-links/:id/status
  • GETpaymentsList/v1/payments
  • POSTpaymentsCreate/v1/payments
  • GETOuvrir le tableau de bord des paiements (Control Center)/v1/payments/console
  • GETpaymentsGet/v1/payments/:id
  • POSTpayoutBatchesCreate/v1/payout-batches
  • GETpayoutBatchesGet/v1/payout-batches/:id
  • GETpayoutDestinationsList/v1/payout-destinations
  • POSTpayoutDestinationsAdd/v1/payout-destinations
  • DELETEpayoutDestinationsRemove/v1/payout-destinations/:id
  • POSTpayoutDestinationsResend/v1/payout-destinations/:id/resend
  • POSTpayoutDestinationsVerify/v1/payout-destinations/:id/verify
  • POSTpayoutQuotesCreate/v1/payout-quotes
  • GETpayoutsList/v1/payouts
  • POSTpayoutsCreate/v1/payouts
  • GETpayoutsGet/v1/payouts/:id
  • POSTpayoutsCancel/v1/payouts/:id/cancel
  • GETpayoutsReceipt/v1/payouts/:id/receipt
  • GETrailsList/v1/rails
  • PUTrailsSetEnabled/v1/rails/:id/enabled
  • POSTrefundQuotesCreate/v1/refund-quotes
  • GETrefundsList/v1/refunds
  • POSTrefundsCreate/v1/refunds
  • GETrefundsGet/v1/refunds/:id
  • GETsettingsGet/v1/settings
  • PUTsettingsUpdate/v1/settings
  • GETtransactionHistory/v1/transactions/:id/history
  • GETwebhookEventsList/v1/webhook-events
  • GETwebhookEventAttempts/v1/webhook-events/:id/attempts
  • POSTwebhookEventRetry/v1/webhook-events/:id/retry

banques

  • GETBanques/v1/banques
  • GETBanques : une fiche/v1/banques/:id

categories

  • GETCatégories de l'annuaire/v1/categories
  • GETCatégories de l'annuaire : une fiche/v1/categories/:id

comptes

  • DELETESupprimer mon compte et mes projets (clés révoquées, irréversible) : connexion de moins de 10 minutes (/auth/connexion?recent=1)/v1/compte
  • GETExporter mes données : profil, projets, clés (sans secret), journal des appels, webhooks et livraisons, favoris, abonnements et signalements/v1/compte/export
  • GETAperçu public d'une invitation : projet, rôle, adresse masquée, état/v1/invitations/:token
  • POSTAccepter une invitation avec le compte connecté (même adresse e-mail)/v1/invitations/:token/accepter
  • GETMes projets (20 au plus)/v1/projets
  • POSTCréer un projet (20 au plus par utilisateur)/v1/projets
  • GETTableau de bord du projet : clés, consommation, journal, webhooks/v1/projets/:id
  • PUTRenommer un projet (administrateurs du projet)/v1/projets/:id
  • DELETESupprimer un projet : clés révoquées, webhooks supprimés (irréversible)/v1/projets/:id
  • GETDemande d'avis sur 221 Pay : à montrer ou non/v1/projets/:id/avis
  • POSTDonner un avis sur 221 Pay/v1/projets/:id/avis
  • POSTRepousser la demande d'avis de 7 jours/v1/projets/:id/avis/plus-tard
  • GETCandidature 221 Pay du projet : état, réponses et listes de choix/v1/projets/:id/candidature-221-pay
  • POSTDéposer la candidature 221 Pay et signer le contrat (administrateurs du projet)/v1/projets/:id/candidature-221-pay
  • POSTCréer une clé API (5 clés actives au plus ; le secret n’est affiché qu’une fois)/v1/projets/:id/cles
  • DELETERévoquer une clé API/v1/projets/:id/cles/:keyId
  • POSTRemplacer une clé API : nouvelle clé (même nom, mode, portées et quota), l'ancienne reste valide pendant le délai choisi/v1/projets/:id/cles/:keyId/rotate
  • POSTInviter une personne par e-mail (valable 7 jours, usage unique)/v1/projets/:id/invitations
  • DELETERetirer une invitation en attente/v1/projets/:id/invitations/:invId
  • GETMode live du projet : les clés live déplacent de l'argent réel/v1/projets/:id/live
  • PUTActiver ou désactiver le mode live du projet (administrateurs du projet ; confirmation obligatoire pour activer)/v1/projets/:id/live
  • GETMembres du projet et invitations en attente/v1/projets/:id/membres
  • PUTChanger le rôle d'un membre (le dernier administrateur reste)/v1/projets/:id/membres/:userId
  • DELETERetirer un membre ou quitter le projet (le dernier administrateur reste)/v1/projets/:id/membres/:userId
  • GETPoints de terminaison webhook du projet/v1/projets/:id/webhooks
  • POSTAjouter un point de terminaison webhook (une URL, des événements du catalogue)/v1/projets/:id/webhooks
  • DELETESupprimer un abonnement/v1/projets/:id/webhooks/:subscriptionId
  • PATCHChoisir les événements et les modes d’un point de terminaison webhook/v1/projets/:id/webhooks/:subscriptionId
  • POSTEnvoyer un événement test.ping signé au point de terminaison (3 par minute au plus)/v1/projets/:id/webhooks/:subscriptionId/test

jours-feries

  • GETDate obtenue en ajoutant N jours ouvrés/v1/delais?from=2026-10-01&days=0
  • GETJours fériés du Sénégal/v1/jours-feries
  • GETNombre de jours ouvrés entre deux dates incluses/v1/jours-feries/ouvres?from=2026-10-01&to=2026-10-01
  • GETJours fériés du Sénégal : une fiche/v1/jours-feries/:id

demandes

  • GETDemandes d’API et de données manquantes, les plus votées d’abord/v1/demandes
  • POSTDemander une API ou un jeu de données manquant (vote compris)/v1/demandes
  • PUTVoter pour une demande (idempotent)/v1/demandes/:id/vote
  • DELETERetirer son vote (idempotent)/v1/demandes/:id/vote

demarches

  • GETDémarches réglementaires/v1/demarches
  • GETDémarches réglementaires : une fiche/v1/demarches/:id

geographie

  • GETLieux : filtre par niveau, parent ou recherche tolérante/v1/geographie
  • GETDistance à vol d'oiseau entre deux lieux ou points/v1/geographie/distance?from=reg_om6lpn2l&to=14.7910,-16.9359
  • GETRattacher un point GPS à sa région, son département, son arrondissement et sa commune (géocodage inverse)/v1/geographie/rattacher?lat=14.6928&lon=-17.4467
  • GETUn lieu avec ses ancêtres et ses enfants/v1/geographie/:id

jeux

  • GETJeux de données du catalogue (sources avec indicateur official)/v1/jeux
  • GETJeux de données du catalogue (sources avec indicateur official) : une fiche/v1/jeux/:id

modules

  • GETModules du hub/v1/modules
  • GETModules du hub : une fiche/v1/modules/:id

moi

  • GETMes abonnements aux nouvelles versions (e-mail)/v1/moi/abonnements
  • GETÉtat d’un jeu dans mes abonnements aux nouvelles versions (e-mail)/v1/moi/abonnements/:jeu
  • PUTAjouter un jeu à mes abonnements aux nouvelles versions (e-mail) (idempotent)/v1/moi/abonnements/:jeu
  • DELETERetirer un jeu de mes abonnements aux nouvelles versions (e-mail) (idempotent)/v1/moi/abonnements/:jeu
  • GETProjet, mode et portées de la clé API qui appelle/v1/moi/cle
  • GETVersion des conditions d’utilisation et acceptation du compte/v1/moi/conditions
  • POSTAccepter la version courante des conditions d’utilisation/v1/moi/conditions
  • GETMes favoris/v1/moi/favoris
  • GETÉtat d’un jeu dans mes favoris/v1/moi/favoris/:jeu
  • PUTAjouter un jeu à mes favoris (idempotent)/v1/moi/favoris/:jeu
  • DELETERetirer un jeu de mes favoris (idempotent)/v1/moi/favoris/:jeu
  • GETQuestions d’accueil et réponses du compte/v1/moi/onboarding
  • PUTEnregistrer une réponse d’accueil (idempotent)/v1/moi/onboarding/:question

monnaie

  • GETFormater un montant en FCFA, en lettres et en euros (parité fixe)/v1/monnaie/format?montant=1250000

operateurs

  • GETPréfixes des opérateurs de téléphonie/v1/operateurs
  • GETPréfixes des opérateurs de téléphonie : une fiche/v1/operateurs/:id

secteurs

  • GETSecteurs « Que construisez-vous ? »/v1/secteurs
  • GETSecteurs « Que construisez-vous ? » : une fiche/v1/secteurs/:id

signalements

  • POSTSignaler une erreur de donnée (Turnstile, 5 envois par heure et par adresse IP, idempotent)/v1/signalements
  • GETStatut public d’un signalement (sans e-mail)/v1/signalements/:numero

telechargements

  • GETPopularité des jeux : téléchargements et ouvertures comptés par le hub/v1/telechargements
  • POSTCompter un téléchargement ou une ouverture (anonyme, une fois par jour et par adresse IP)/v1/telechargements/:jeu

telephone

  • GETAnalyser, valider et formater un numéro sénégalais/v1/telephone/analyse?numero=77 123 45 67

webhooks

  • GETCatalogue des événements webhook, par produit (payments, data)/v1/webhook-event-types
  • GETÉtat du service/health

API details

Base URL
https://apps.orvlabs.com
Authentication
A bearer token in the Authorization header
An API key in the __Secure-better-auth.session_token cookie
Operations
140 operations on 112 pathsGET 80POST 37PUT 11DELETE 11PATCH 1
Main resources
payments 59comptes 29moi 13demandes 4geographie 4jours-feries 4adresses 3annuaire 2banques 2categories 2
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the 221 in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the 221 collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Géocoder une adresse descriptive au lieu connu le plus fin” (GET /v1/adresses/geocoder?texte=En face de la pharmacie, Médina, Dakar), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the 221?

Données de référence, outils et paiements pour les développeurs au Sénégal. Premiers pas : 1. Créer un projet dans le tableau de bord. 2. Créer une clé API… It is listed under Data & analytics and has 140 endpoints.

Who publishes the 221?

It is listed from Orvlabs's public API description (an OpenAPI document), not published by Orvlabs on Swastik Codes. Anyone who controls 221.orvlabs.com can claim the profile by adding a DNS TXT record.

What is the base URL of the 221?

Requests go to https://apps.orvlabs.com. Endpoint paths are added to this base URL.

How do I authenticate with the 221?

It accepts 2 methods: A bearer token in the Authorization header; an API key in the __Secure-better-auth.session_token cookie.

How many endpoints does the 221 have?

140 operations on 112 paths (80 GET, 37 POST, 11 PUT, 11 DELETE, 1 PATCH). The largest groups are payments, comptes, moi, demandes.

Is forking the 221 free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.