---
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`

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.net/neotimo/apis/neotimo-api.md) · [All operations](https://skmtc.net/neotimo/apis/neotimo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neotimo/neotimo-api/revisions/2ecf51b1543e/schema)