> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar marcadores de fraude > Se devuelven los marcadores de fraude registrados para el tax_id_number obligatorio dentro del alcance del participante determinado por el tenant autenticado. Los filtros opcionales son key, status (REGISTERED o CANCELLED), modified_after y modified_before (RFC3339), y limit (de 1 a 200). limit no tiene valor predeterminado y solo se aplica cuando se informa. ## OpenAPI ````yaml es/openapi/v3-current/pix-lerian-dict.yaml GET /dict/fraud-markers openapi: 3.1.0 info: contact: name: Lerian Studio url: https://lerian.studio description: >- API pública para claves Pix, reclamos, marcadores de fraude, reportes de infracción y recuperación de fondos del MED. license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license title: Pix Lerian — DICT version: release-candidate servers: - url: https://api.example.com/dict-hub/v1 description: >- El host de ejemplo debe reemplazarse por la URL proporcionada durante el onboarding del entorno. security: - BearerAuth: [] tags: - description: Registro, consulta, listado, actualización y eliminación de claves Pix. name: Entries - description: >- Consulta de claves Pix y verificación de su existencia en el directorio DICT. name: Keys - description: Gestión de reclamaciones de titularidad y portabilidad de claves Pix. name: Claims - description: Gestión de recuperaciones de fondos de MED 2.0 asociadas al participante. name: Funds Recoveries - description: >- Gestión de reportes de infracción de MED 2.0 para la organización autenticada. name: Infraction Reports - description: Creación, consulta, cancelación y liquidación de devoluciones de MED 2.0. name: Refunds - description: Creación, consulta, listado y cancelación de marcadores de fraude de DICT. name: Fraud Markers paths: /dict/fraud-markers: get: tags: - Fraud Markers summary: Listar marcadores de fraude description: >- Se devuelven los marcadores de fraude registrados para el tax_id_number obligatorio dentro del alcance del participante determinado por el tenant autenticado. Los filtros opcionales son key, status (REGISTERED o CANCELLED), modified_after y modified_before (RFC3339), y limit (de 1 a 200). limit no tiene valor predeterminado y solo se aplica cuando se informa. operationId: listFraudMarkers parameters: - description: CPF (11 digits) or numeric CNPJ (14 digits) to filter by explode: false in: query name: tax_id_number required: true schema: description: CPF (11 digits) or numeric CNPJ (14 digits) to filter by examples: - '12345678901' type: string example: '12345678901' - description: >- Optional Pix key filter. Maximum 77 BYTES UTF-8, not characters -- see CreateFraudMarkerBody.Key. explode: false in: query name: key schema: description: >- Optional Pix key filter. Maximum 77 BYTES UTF-8, not characters -- see CreateFraudMarkerBody.Key. examples: - user@example.com type: string example: pix-demo@example.com - description: Optional status filter explode: false in: query name: status schema: description: Optional status filter enum: - REGISTERED - CANCELLED examples: - REGISTERED type: string example: REGISTERED - description: Optional RFC 3339 lower bound on lastModified explode: false in: query name: modified_after schema: description: Optional RFC 3339 lower bound on lastModified examples: - '2026-08-01T00:00:00Z' format: date-time type: string example: '2026-08-01T00:00:00Z' - description: Optional RFC 3339 upper bound on lastModified explode: false in: query name: modified_before schema: description: Optional RFC 3339 upper bound on lastModified examples: - '2026-08-19T23:59:59Z' format: date-time type: string example: '2026-08-19T23:59:59Z' - description: Optional page size, 1..200 explode: false in: query name: limit schema: description: Optional page size, 1..200 examples: - '50' type: string example: '50' responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListDICTFraudMarkersOutput' examples: ejemploFicticio: summary: Ejemplo ficticio value: fraudMarkers: [] hasMoreElements: false total: 1 description: Matching fraud markers (possibly empty). '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: >- Missing or malformed query parameter -- taxIdNumber absent, limit outside 1..200, status outside its domain, or an invalid modifiedAfter/modifiedBefore (PIX-0020). '429': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: The provider rate-limited this operation; retry later (PIX-0134). '502': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: >- The provider adapter call failed outright -- an unreachable adapter or an unclassified upstream failure (PIX-0141). '504': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: The provider call did not complete within its deadline (PIX-0054). default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error x-codeSamples: - lang: bash label: cURL con datos ficticios source: |- curl --request GET \ --url https://api.example.com/dict-hub/v1/dict/fraud-markers?tax_id_number=12345678901 \ --header 'Authorization: Bearer demo-access-token' components: schemas: ListDICTFraudMarkersOutput: additionalProperties: false properties: fraudMarkers: description: Matching fraud markers, empty when none match examples: - [] items: $ref: '#/components/schemas/DICTFraudMarker' type: array hasMoreElements: description: Whether more results exist beyond this page examples: - false type: boolean total: description: Total number of matching fraud markers examples: - 1 format: int64 type: integer required: - fraudMarkers - total - hasMoreElements type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object DICTFraudMarker: additionalProperties: false properties: creationTime: description: When the marker was registered at the provider (RFC 3339 UTC) examples: - '2026-08-21T10:00:00Z' format: date-time type: string fraudType: enum: - APPLICATION_FRAUD - MULE_ACCOUNT - SCAMMER_ACCOUNT - OTHER - UNKNOWN examples: - APPLICATION_FRAUD type: string id: description: Directory fraud-marker id examples: - 0b843bcc-7c1a-4a12-9c88-8d3a5d70e6a1 format: uuid type: string infractionReport: $ref: '#/components/schemas/DICTFraudMarkerInfractionReport' description: >- The infraction report the provider created this marker from, when applicable key: description: Pix key linked to the marker, when one was supplied on create examples: - '+5561999998888' type: string lastModified: description: When the marker was last modified at the provider (RFC 3339 UTC) examples: - '2026-08-21T10:00:00Z' format: date-time type: string status: enum: - REGISTERED - CANCELLED examples: - REGISTERED type: string taxIdNumber: description: CPF (11 digits) or numeric CNPJ (14 digits) marked examples: - '12345678901' type: string required: - id - status - taxIdNumber - fraudType - creationTime - lastModified type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object DICTFraudMarkerInfractionReport: additionalProperties: false properties: id: description: Infraction report id at the provider examples: - 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b type: string reporterParticipant: description: ISPB of the participant that opened the infraction report examples: - '18236120' type: string required: - id - reporterParticipant type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````