Pappers

Not authenticated— sign in to auto-fill your API key in code examples

Search companies

GET/v1/pappers/search

Parameter	Required	Description
`q`string	required	Search query (company name, SIREN, or SIRET).
`page`integer	optional	Page number (1-based).

Response200

{
  "ok": true,
  "companies": [
    {
      "siren": "380129866",
      "siret": "38012986600084",
      "name": "CHRONOPOST",
      "legalForm": "SAS",
      "city": "ISSY-LES-MOULINEAUX",
      "postalCode": "92130",
      "active": true
    },
    {
      "siren": "383960135",
      "siret": "38396013500014",
      "name": "CHRONOPOST FOOD",
      "legalForm": "SAS",
      "city": "PARIS",
      "postalCode": "75008",
      "active": true
    }
  ],
  "total": 2,
  "page": 1
}

Response400

{
  "ok": false,
  "error": "Invalid request parameters",
  "code": "VALIDATION_ERROR",
  "details": {
    "field": "email",
    "reason": "must be a valid email address"
  }
}

Response401

{
  "ok": false,
  "error": "Authentication required",
  "code": "UNAUTHORIZED",
  "details": {}
}

Response429

{
  "ok": false,
  "error": "Rate limit exceeded. Retry after 30 seconds.",
  "code": "RATE_LIMIT_EXCEEDED",
  "details": {
    "retryAfter": 30
  }
}

Get company

GET/v1/pappers/company/:siren

Parameter	Required	Description
`siren`string	required	9-digit SIREN number.

Response200

{
  "ok": true,
  "company": {
    "siren": "380129866",
    "siret": "38012986600084",
    "name": "CHRONOPOST",
    "legalForm": "SAS",
    "registrationDate": "1991-11-01",
    "address": {
      "street": "3 Boulevard Romain Rolland",
      "postalCode": "92130",
      "city": "ISSY-LES-MOULINEAUX",
      "country": "FR"
    },
    "nafCode": "5320Z",
    "nafLabel": "Autres activites de poste et de courrier",
    "active": true,
    "employeeRange": "5000 a 9999 salaries",
    "capital": 29000000
  }
}

Response401

{
  "ok": false,
  "error": "Authentication required",
  "code": "UNAUTHORIZED",
  "details": {}
}

Response404

{
  "ok": false,
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "details": {}
}

Response429

{
  "ok": false,
  "error": "Rate limit exceeded. Retry after 30 seconds.",
  "code": "RATE_LIMIT_EXCEEDED",
  "details": {
    "retryAfter": 30
  }
}