KYB Sovereign API Reference

v2.7.49 ProductionLoi 25-11 Compliant

High-velocity enterprise integration for Algerian corporate identity resolution, commercial registry indexing, and retroactive invoice tax compliance.

Standard Endpoints
Zero-Cost Deterministic Sandbox

Any NIF starting with prefix 0000 bypasses live scraping and Redis billing entirely (ADR #8). Use it for continuous unit tests and local staging verification.

GET/api/v1/entity/resolveEntity Resolution

Single-Identifier Resolution

Auto-detects identifier type (15/20-digit NIF, Algerian RC number, or Raison Sociale) in <100ms and returns verified identity attributes. Deducts 1 credit (auto-refunded on 404).

Legal & Fiscal Basis: Executive Decree n° 05-468 & Decree n° 97-40 (Official Registration)
Required HTTP Headers
HeaderTypeDescription
AuthorizationrequiredProduction Secret API Key or Sandbox Token
AcceptrequiredExpected JSON response format
Request Parameters
FieldTypeDescriptionExample
qstring15/20-digit NIF, Algerian RC number (e.g. 16B0012345), or Company Name000816097764131

Interactive Request Console

Test the live API directly from your browser using your custom API key or deterministic sandbox NIFs (0000).

curl -X GET "https://kyb.digidevagency.dz/api/v1/entity/resolve?q=000816097764131" \
  -H "Authorization: Bearer sk_test_kyb_sandbox_key_001" \
  -H "Accept: application/json" \
  -H "Accept-Language: fr"
Sample Response
{
  "id": "ent_algerie_telecom_01",
  "rcNumber": "16/00-0012345B00",
  "nif": "000816097764131",
  "nis": "000816090001456",
  "articleImposition": "16090123456",
  "raisonSociale": "ALGERIE TELECOM SPA",
  "sigle": "AT",
  "formeJuridique": "SPA",
  "statutCnrc": "ACTIF",
  "isNifValid": true,
  "wilaya": "16 - ALGER",
  "commune": "Mohammadia",
  "adresse": "Route Nationale N° 5, Cinq Maisons, Mohammadia, Alger",
  "capitalSocial": "115000000000 DZD",
  "isGolden": true,
  "source": "both",
  "updatedAt": "2026-10-06T10:00:00Z"
}

Avertissement Réglementaire : KYB by Digidev Agency est une plateforme technologique d'aide à la décision et d'agrégation de registres légaux publics. Les contrôles automatisés ne constituent en aucun cas une consultation juridique ou fiscale. La responsabilité de la conformité des déclarations et de la déductibilité fiscale relève de l'entreprise et de ses conseils habilités.