PEpennylane
PA Registrations

List PA Registrations

Changed on

Returns all PA (Plateforme Agrée) registrations for the company, including activation status and exchange direction. Use this to determine whether the company has completed PA onboarding. Records with a null siret represent the SIREN-level (head office), other records represent establishments.

⚠️ By default, addresses of every status are returned. Only activated addresses are relevant to receive invoices, so we recommend filtering on the activated status: filter=[{"field":"status","operator":"eq","value":"activated"}]. In a future version, only activated addresses will be returned, and the exchange_direction property will be removed.

ℹ️ This endpoint requires the following scope: pa_registrations:readonly

get/api/external/v2/pa_registrations

Request

  • Base URL
    https://app.pennylane.com
  • URL
    https://app.pennylane.com/api/external/v2/pa_registrations
  • Auth
    OAuth 2
    Authorization code: https://app.pennylane.com/oauth/authorize
    Token URL: https://app.pennylane.com/oauth/oauth/token scopes: pa_registrations:readonly

Query parameters

filterstring
Example:[{"field": "status", "operator": "eq", "value": "activated"}]

You can choose to filter items on specific fields. Available fields and operators:

  • id: lt, lteq, gt, gteq, eq, not_eq, in, not_in
  • siret: eq, not_eq, in, not_in
  • status: eq, not_eq, in, not_in

We recommend filtering on the activated status to only get the addresses that are live in the PA directory.

sortstring
Example:id

You can choose to sort items on specific attributes. Sort field may be prefixed with - for descending order. Example: id will sort by ascending order, -id will sort by descending order. Available fields: id

Headers

X-Company-Idstring
Example:12345

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Response

List of PA registrations for the company

emission_activatedboolean required

Whether the company has activated invoice emission through Pennylane. true when the company is enabled to send invoices via Pennylane's emission feature, regardless of whether a PPF routing address exists. Use this alongside items to determine the full PA registration state.

has_moreboolean required

Indicates whether additional results are available beyond this set. Use this flag to determine if another request is needed.

next_cursorstring nullable required

Cursor to retrieve the next set of results. Include this value in the cursor parameter of your next request to fetch subsequent items. A null next_cursor in the response indicates no further results.

Example response

{
  "has_more": true,
  "next_cursor": "dXBkYXRlZF9hdDoxNjc0MTIzNDU2",
  "items": [
    {
      "id": 1,
      "siret": "98493148500010",
      "siren": "993369859",
      "suffix": "invoices",
      "routing_code": "ROUTING-01",
      "exchange_direction": "emission_and_reception",
      "effective_until": "2027-01-01",
      "created_at": "2026-02-23T10:53:00.000Z",
      "updated_at": "2026-02-23T10:53:00.000Z"
    }
  ]
}

Changes

  • 871f863307e5Revision changes
    • warning

      added the new lost enum value to the // response property for the response status

    • info

      added the new optional header request parameter X-Company-Id

    • info

      added the new optional query request parameter filter

    • info

      added the new optional query request parameter sort

    • info

      response property items/items/exchange_direction deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status