> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Get alert

> Retrieves a single fraud alert by its unique identifier.



## OpenAPI

````yaml /api-reference/openapi.json get /fraud-alerts/{id}
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sandbox.api.reap.global
    description: Sandbox
  - url: https://prod.api.reap.global
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Fraud Alerts
  - name: Policies
  - name: Simulation
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
paths:
  /fraud-alerts/{id}:
    get:
      tags:
        - Fraud Alerts
      summary: Get alert
      description: Retrieves a single fraud alert by its unique identifier.
      operationId: get_fraud-alerts
      parameters:
        - name: id
          in: path
          required: true
          schema:
            description: Fraud alert ID
            type: string
            format: uuid
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
      responses:
        '200':
          description: Fraud alert resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FraudAlert'
        '404':
          description: Fraud alert not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        const: FRAUD_ALERT_NOT_FOUND
                      message:
                        type: string
                      detail:
                        anyOf:
                          - type: object
                            additionalProperties: {}
                          - type: 'null'
                    required:
                      - code
                      - message
                      - detail
                required:
                  - error
                title: FraudAlertNotFoundError
components:
  schemas:
    FraudAlert:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique fraud alert identifier
        cardId:
          type: string
          format: uuid
          description: ID of the card this alert is for
        transactionId:
          type: string
          format: uuid
          description: ID of the card transaction this alert is for
        status:
          type: string
          enum:
            - PENDING
            - CONFIRMED
            - DECLINED
            - EXPIRED
          description: Current fraud alert status
          example: PENDING
        origin:
          type: string
          enum:
            - DETECTED
            - REPORTED
          description: >-
            How the alert entered the system (`DETECTED` via fraud monitoring,
            or `REPORTED` by the partner)
          example: DETECTED
        type:
          anyOf:
            - type: string
              enum:
                - CARD_LOST
                - CARD_STOLEN
                - ACCOUNT_NUMBER_MISUSE
                - OTHER
              description: >-
                - `CARD_LOST`: The cardholder lost the card

                - `CARD_STOLEN`: The card was stolen

                - `ACCOUNT_NUMBER_MISUSE`: The cardholder still has the card,
                the account number was used without it

                - `OTHER`: Confirmed fraud that none of the other types classify
              example: CARD_LOST
            - type: 'null'
          description: >-
            Fraud classification. Present only when status is `CONFIRMED`; null
            for others
        detectionReason:
          anyOf:
            - type: string
            - type: 'null'
          description: Reason supplied with a detected alert, when present
        cardholderMessage:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Cardholder-facing message from the Reap or Card Network, when
            present. Display only - do not branch on its contents
        transactionOccurredAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: >-
            ISO 8601 timestamp of the underlying transaction (anchors the
            reporting window)
        detectedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: >-
            ISO 8601 timestamp when the alert was raised (anchors the response
            window)
        respondedAt:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            - type: 'null'
          description: >-
            ISO 8601 timestamp when the alert was confirmed or declined, if
            resolved that way
        resolvedAt:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            - type: 'null'
          description: ISO 8601 timestamp when the alert reached a terminal status
        reportableUntil:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            - type: 'null'
          description: >-
            ISO 8601 deadline for a report after an unanswered detected alert
            expired. Null unless status is `EXPIRED`
        respondableUntil:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 deadline for confirming or declining a detected alert
        createdAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 timestamp of last update
      required:
        - id
        - cardId
        - transactionId
        - status
        - origin
        - type
        - detectionReason
        - cardholderMessage
        - transactionOccurredAt
        - detectedAt
        - respondedAt
        - resolvedAt
        - reportableUntil
        - respondableUntil
        - createdAt
        - updatedAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````