> ## Documentation Index > Fetch the complete documentation index at: https://developers.marko.fr/llms.txt > Use this file to discover all available pages before exploring further. # Lister une taxonomie d'entité > Retourne les options visibles décidées par l'administrateur de l'entité. Une option courante masquée peut être demandée avec current_code afin de rester affichable sans être proposée pour une nouvelle sélection. ## OpenAPI ````yaml https://partner-api.marko.fr/v1/openapi.json get /taxonomies openapi: 3.1.0 info: title: MARKO External Partner API version: v1 description: >- Stable external API contract for the live environment. Authentication flow for partner integrations: 1. Generate an API key from the MARKO entity admin API section. 2. Keep the raw API secret server-side and use it only to sign `POST /v1/auth/token`. 3. Build the canonical message `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`. 4. Sign that message with HMAC-SHA256 and send the hex signature with `key_id`, `timestamp` and `nonce`. 5. Use the returned short-lived bearer on business endpoints as `Authorization: Bearer `. The raw API secret must never be sent on business endpoints. This public contract intentionally excludes beta endpoints. servers: - url: https://partner-api.marko.fr/v1 security: - BearerAuth: [] externalDocs: description: Download the matching Postman collection. url: /v1/postman.json paths: /taxonomies: get: tags: - taxonomies summary: Lister une taxonomie d'entité description: >- Retourne les options visibles décidées par l'administrateur de l'entité. Une option courante masquée peut être demandée avec current_code afin de rester affichable sans être proposée pour une nouvelle sélection. operationId: taxonomies_list parameters: - in: query name: dimension required: false schema: type: string enum: - operation_status - investment_type - operation_type - asset_class - internal_status - operational_status - follow_up_category example: operation_status - in: query name: current_code required: false schema: type: string maxLength: 180 description: Code courant à inclure même s'il est masqué. - in: header name: X-Request-ID required: false description: >- Partner-generated correlation identifier echoed in logs and error payloads. schema: type: string example: marko-taxonomies-list responses: '200': description: Successful response content: application/json: schema: properties: items: items: properties: parent_code: anyOf: - enum: - due_diligence - en_cours - en_recouvrement - termine type: string - type: 'null' default: null title: Parent Code code: title: Code type: string dimension: enum: - operation_status - investment_type - operation_type - asset_class - internal_status - operational_status - follow_up_category title: Dimension type: string display_label: title: Display Label type: string source_kind: enum: - marko - partner - entity title: Source Kind type: string source_display_name: title: Source Display Name type: string is_visible: title: Is Visible type: boolean is_active: title: Is Active type: boolean position: title: Position type: integer usage_count: default: 0 title: Usage Count type: integer label_editable: title: Label Editable type: boolean canonical_code: anyOf: - type: string - type: 'null' default: null title: Canonical Code icon_key: anyOf: - enum: - tag - briefcase - building - landmark - home - map - layers - shield - trending-up - calendar - circle-check - triangle-alert type: string - type: 'null' default: null title: Icon Key required: - code - dimension - display_label - source_kind - source_display_name - is_visible - is_active - position - label_editable title: EntityTaxonomyOptionResponse type: object title: Items type: array required: - items title: EntityTaxonomyOptionListResponse type: object example: items: - code: instruction dimension: operation_status display_label: Instruction source_kind: marko source_display_name: MARKO is_visible: true is_active: true position: 1 usage_count: 0 label_editable: false canonical_code: instruction '401': description: Authentication required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unauthorized status: 401 detail: A valid bearer token is required. request_id: req_example_partner_call '403': description: Scope, route or IP restriction content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Forbidden status: 403 detail: The API key does not allow this operation. request_id: req_example_partner_call '422': description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unprocessable Content status: 422 detail: The request payload or parameters are invalid. request_id: req_example_partner_call '429': description: Rate limit or progressive ban headers: Retry-After: description: Cooldown in seconds before retrying the request. schema: type: string content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Too Many Requests status: 429 detail: The request rate limit was exceeded. request_id: req_example_partner_call '500': description: Unexpected server error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Internal Server Error status: 500 detail: An unexpected server error occurred. request_id: req_example_partner_call deprecated: false security: - BearerAuth: [] components: schemas: ProblemDetails: type: object required: - title - status - detail properties: type: type: string default: about:blank title: type: string status: type: integer detail: type: string request_id: type: string scope: type: string route_id: type: string reason_code: type: string securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: MARKO short-lived bearer description: >- Use the `access_token` returned by `POST /v1/auth/token`. Do not send the raw API secret on business endpoints. ````