---
title: "🇫🇷 Norme · SIREN search (or legal unit)"
method: POST
path: "/directory-service/v1/siren/search"
tags: ["AFNOR XP Z12-013/DirectoryService"]
---

# 🇫🇷 Norme · SIREN search (or legal unit)

`POST /directory-service/v1/siren/search`

## Request

- Base URL: `https://api.neotimo.com`
- URL: `https://api.neotimo.com/directory-service/v1/siren/search`
- Auth: HTTP bearer and API key in header `X-Api-Key`

Multi-criteria company search.

## Request body

- SearchSiren
  - `filters` SearchSirenFilters
    - `siren` SearchSirenFiltersSiren
      - `op` 'Strict': \"strict\" comparison operator
      - `value` string, nullable
    - `businessName` SearchSirenFiltersBusinessName
      - `op` 'Contains' | 'Strict' | 'StartWith': \"contains\", \"strict\" or \"startWith\" comparison operator
      - `value` string, nullable
    - `entityType` SearchSirenFiltersEntityType
      - `op` 'Strict': \"strict\" comparison operator
      - `value` 'Public' | 'PrivateVatRegistered': Business structure type
    - `administrativeStatus` SearchSirenFiltersAdministrativeStatus
      - `op` 'Strict': \"strict\" comparison operator
      - `value` 'A' | 'C': Refers to the administrative status of the legal unit [A - Active , C - Closed]
  - `sorting` SearchSirenSortingInner[], nullable: Sorting criteria on a field and an order (ascending or descending).
    - `field` 'Siren' | 'BusinessName' | 'EntityType' | 'AdministrativeStatus' | 'Instructions': Fields of the Siren resource.
    - `order` 'Ascending' | 'Descending': Sorting order (ascending or descending)
  - `fields` SirenField[], nullable: Allows you to filter the desired fields in the response.
  - `limit` integer, nullable
  - `ignore` integer, nullable

## Response `200`

OK

- SirenSearchPost200Response
  - `search` SearchSiren
    - `filters` SearchSirenFilters
      - `siren` SearchSirenFiltersSiren
        - `op` 'Strict': \"strict\" comparison operator
        - `value` string, nullable
      - `businessName` SearchSirenFiltersBusinessName
        - `op` 'Contains' | 'Strict' | 'StartWith': \"contains\", \"strict\" or \"startWith\" comparison operator
        - `value` string, nullable
      - `entityType` SearchSirenFiltersEntityType
        - `op` 'Strict': \"strict\" comparison operator
        - `value` 'Public' | 'PrivateVatRegistered': Business structure type
      - `administrativeStatus` SearchSirenFiltersAdministrativeStatus
        - `op` 'Strict': \"strict\" comparison operator
        - `value` 'A' | 'C': Refers to the administrative status of the legal unit [A - Active , C - Closed]
    - `sorting` SearchSirenSortingInner[], nullable: Sorting criteria on a field and an order (ascending or descending).
      - `field` 'Siren' | 'BusinessName' | 'EntityType' | 'AdministrativeStatus' | 'Instructions': Fields of the Siren resource.
      - `order` 'Ascending' | 'Descending': Sorting order (ascending or descending)
    - `fields` SirenField[], nullable: Allows you to filter the desired fields in the response.
    - `limit` integer, nullable
    - `ignore` integer, nullable
  - `totalNumberOfResults` integer, nullable
  - `results` LegalUnitPayloadHistory[], nullable
    - `siren` string, nullable
    - `businessName` string, nullable
    - `entityType` 'Public' | 'PrivateVatRegistered': Business structure type
    - `administrativeStatus` 'A' | 'C': Refers to the administrative status of the legal unit [A - Active , C - Closed]
    - `instructions` SirenInstructions: Instructions regarding the SIREN
      - `isSalesProspectingForbidden` boolean, nullable

---

[API](https://skmtc.dev/neotimo/apis/neotimo-api.md) - [All operations](https://skmtc.dev/neotimo/apis/neotimo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neotimo/apis/neotimo-api/revisions/d134f2cbfaf5?raw)