{
  "info": {
    "name": "Jsonpage API, discovery / découverte",
    "description": "Jsonpage API, discovery collection (no key inside).\n\n1. Create a free API key in a minute, no card needed: https://jsonpage.com/account\n2. Open the Variables tab of this collection and paste the key in apiKey.\n3. Send the requests. The two health checks work without a key.\n\nPrices and limits: https://jsonpage.com/tarifs. Documentation: https://jsonpage.com/docs. OpenAPI: https://jsonpage.com/openapi.json\n\n---\n\nCollection de découverte de l'API Jsonpage (aucune clé dedans).\n\n1. Créez une clé API gratuite en une minute, sans carte bancaire : https://jsonpage.com/account\n2. Ouvrez l'onglet Variables de cette collection et collez la clé dans apiKey.\n3. Envoyez les requêtes. Les deux tests de disponibilité fonctionnent sans clé.\n\nTarifs et limites : https://jsonpage.com/tarifs. Documentation : https://jsonpage.com/docs. OpenAPI : https://jsonpage.com/openapi.json\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-API-Key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.jsonpage.com/v2",
      "type": "string"
    },
    {
      "key": "rootUrl",
      "value": "https://api.jsonpage.com",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Look up a company by global identifier",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/companies/FR-552032534?include=address,vat",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "companies",
            "FR-552032534"
          ],
          "query": [
            {
              "key": "include",
              "value": "address,vat"
            }
          ]
        },
        "description": "Look up a company by global identifier.\n\nFiche d'une entreprise à partir de son identifiant global (code pays, tiret, numéro national), avec blocs à la demande : adresse, TVA, signaux, annonces légales, sanctions, établissements."
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/companies/FR-552032534?include=address,vat",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "companies",
                "FR-552032534"
              ],
              "query": [
                {
                  "key": "include",
                  "value": "address,vat"
                }
              ]
            },
            "description": "Look up a company by global identifier.\n\nFiche d'une entreprise à partir de son identifiant global (code pays, tiret, numéro national), avec blocs à la demande : adresse, TVA, signaux, annonces légales, sanctions, établissements."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"data\": {\n    \"id\": \"FR-552032534\",\n    \"country\": \"FR\",\n    \"registry_id\": \"552032534\",\n    \"name\": \"DANONE\",\n    \"status\": \"active\",\n    \"legal_form\": {\n      \"code\": \"5599\",\n      \"label\": \"SA a conseil d'administration\",\n      \"scheme\": \"FR-CJ\"\n    },\n    \"activity\": {\n      \"nace\": \"70.10\",\n      \"code\": \"70.10Z\",\n      \"label\": \"Activites des sieges sociaux\",\n      \"scheme\": \"FR-NAF-REV2\"\n    },\n    \"incorporated_on\": \"1955-01-01\",\n    \"closed_on\": null,\n    \"updated_at\": \"2026-10-03T04:00:00Z\",\n    \"address\": {\n      \"line\": \"17 BOULEVARD HAUSSMANN\",\n      \"postal_code\": \"75009\",\n      \"city\": \"PARIS\",\n      \"country\": \"FR\",\n      \"formatted\": \"17 BOULEVARD HAUSSMANN 75009 PARIS\"\n    },\n    \"vat\": {\n      \"number\": \"FR27552032534\",\n      \"status\": \"valid\",\n      \"checked_at\": \"2026-09-20T10:12:00Z\",\n      \"source\": \"EU VAT check\"\n    }\n  },\n  \"meta\": {\n    \"sources\": [\n      {\n        \"name\": \"Official company register: France\",\n        \"country\": \"FR\",\n        \"kind\": \"register\",\n        \"data_date\": \"2026-10-03\"\n      }\n    ],\n    \"includes\": {\n      \"address\": \"ok\",\n      \"vat\": \"ok\"\n    }\n  }\n}"
        }
      ]
    },
    {
      "name": "Search companies by name, or find a registry number in every country served",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/companies?q=danone&country=FR,BE",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "companies"
          ],
          "query": [
            {
              "key": "q",
              "value": "danone"
            },
            {
              "key": "country",
              "value": "FR,BE"
            }
          ]
        },
        "description": "Search companies by name, or find a registry number in every country served.\n\nRecherche d'entreprises par nom, ou par numéro national dans tous les pays servis."
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/companies?q=danone&country=FR,BE",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "companies"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "danone"
                },
                {
                  "key": "country",
                  "value": "FR,BE"
                }
              ]
            },
            "description": "Search companies by name, or find a registry number in every country served.\n\nRecherche d'entreprises par nom, ou par numéro national dans tous les pays servis."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"data\": [\n    {\n      \"id\": \"FR-552032534\",\n      \"country\": \"FR\",\n      \"registry_id\": \"552032534\",\n      \"name\": \"DANONE\",\n      \"status\": \"active\",\n      \"legal_form\": {\n        \"code\": \"5599\",\n        \"label\": \"SA a conseil d'administration\",\n        \"scheme\": \"FR-CJ\"\n      },\n      \"activity\": {\n        \"nace\": \"70.10\",\n        \"code\": \"70.10Z\",\n        \"label\": \"Activites des sieges sociaux\",\n        \"scheme\": \"FR-NAF-REV2\"\n      },\n      \"incorporated_on\": \"1955-01-01\",\n      \"closed_on\": null,\n      \"updated_at\": \"2026-10-03T04:00:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"sources\": [\n      {\n        \"name\": \"Official company register: France\",\n        \"country\": \"FR\",\n        \"kind\": \"register\",\n        \"data_date\": \"2026-10-03\"\n      }\n    ]\n  }\n}"
        }
      ]
    },
    {
      "name": "Suggest companies while the user types",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/autocomplete?q=carrefour&limit=5",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "autocomplete"
          ],
          "query": [
            {
              "key": "q",
              "value": "carrefour"
            },
            {
              "key": "limit",
              "value": "5"
            }
          ]
        },
        "description": "Suggest companies while the user types.\n\nSuggestions d'entreprises pendant la saisie d'un formulaire."
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/autocomplete?q=carrefour&limit=5",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "autocomplete"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "carrefour"
                },
                {
                  "key": "limit",
                  "value": "5"
                }
              ]
            },
            "description": "Suggest companies while the user types.\n\nSuggestions d'entreprises pendant la saisie d'un formulaire."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"data\": [\n    {\n      \"id\": \"FR-652014051\",\n      \"name\": \"CARREFOUR\",\n      \"status\": \"active\",\n      \"postal_code\": \"91300\",\n      \"city\": \"MASSY\",\n      \"kind\": \"company\"\n    }\n  ]\n}"
        }
      ]
    },
    {
      "name": "Check a company identifier, a SIRET and a VAT number in one call",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/validate?id=FR-652014051",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate"
          ],
          "query": [
            {
              "key": "id",
              "value": "FR-652014051"
            }
          ]
        },
        "description": "Check a company identifier, a SIRET and a VAT number in one call.\n\nContrôle d'un identifiant, d'un SIRET et d'un numéro de TVA en un appel."
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/validate?id=FR-652014051",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "validate"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "FR-652014051"
                }
              ]
            },
            "description": "Check a company identifier, a SIRET and a VAT number in one call.\n\nContrôle d'un identifiant, d'un SIRET et d'un numéro de TVA en un appel."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"data\": {\n    \"valid\": true,\n    \"checks\": [\n      {\n        \"code\": \"id_format\",\n        \"ok\": true,\n        \"value\": \"FR-652014051\"\n      },\n      {\n        \"code\": \"siren_key\",\n        \"ok\": true,\n        \"value\": \"652014051\"\n      },\n      {\n        \"code\": \"vat_format\",\n        \"ok\": true,\n        \"value\": \"FR14652014051\"\n      },\n      {\n        \"code\": \"identifiers_match\",\n        \"ok\": true,\n        \"value\": \"FR-652014051\"\n      },\n      {\n        \"code\": \"company_exists\",\n        \"ok\": true,\n        \"value\": \"FR-652014051\"\n      },\n      {\n        \"code\": \"company_active\",\n        \"ok\": true,\n        \"value\": \"active\"\n      },\n      {\n        \"code\": \"vat_registered\",\n        \"ok\": true,\n        \"value\": \"valid\"\n      }\n    ],\n    \"company\": {\n      \"id\": \"FR-652014051\",\n      \"country\": \"FR\",\n      \"registry_id\": \"652014051\",\n      \"name\": \"CARREFOUR\",\n      \"status\": \"active\"\n    }\n  }\n}"
        }
      ]
    },
    {
      "name": "Liveness check",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{rootUrl}}/health/live",
          "host": [
            "{{rootUrl}}"
          ],
          "path": [
            "health",
            "live"
          ]
        },
        "description": "Liveness check.\n\nTest de disponibilité du service.",
        "auth": {
          "type": "noauth"
        }
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{rootUrl}}/health/live",
              "host": [
                "{{rootUrl}}"
              ],
              "path": [
                "health",
                "live"
              ]
            },
            "description": "Liveness check.\n\nTest de disponibilité du service.",
            "auth": {
              "type": "noauth"
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"status\": \"ok\"\n}"
        }
      ]
    },
    {
      "name": "State of the data",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{rootUrl}}/health/sources",
          "host": [
            "{{rootUrl}}"
          ],
          "path": [
            "health",
            "sources"
          ]
        },
        "description": "State of the data.\n\nÉtat des données et date de dernière mise à jour.",
        "auth": {
          "type": "noauth"
        }
      },
      "response": [
        {
          "name": "Example",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{rootUrl}}/health/sources",
              "host": [
                "{{rootUrl}}"
              ],
              "path": [
                "health",
                "sources"
              ]
            },
            "description": "State of the data.\n\nÉtat des données et date de dernière mise à jour.",
            "auth": {
              "type": "noauth"
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"status\": \"ok\",\n  \"checked_at\": \"2026-10-03T08:00:00Z\",\n  \"sources\": [\n    {\n      \"country\": \"FR\",\n      \"status\": \"ok\"\n    },\n    {\n      \"country\": \"BE\",\n      \"status\": \"ok\"\n    },\n    {\n      \"country\": \"GB\",\n      \"status\": \"refreshing\"\n    }\n  ]\n}"
        }
      ]
    }
  ]
}