---
title: "Get the RECEIVER webhook record"
method: GET
path: "/v1/transactions/{reference}/webhooks/receiver"
tags: ["Webhooks"]
---

# Get the RECEIVER webhook record

`GET /v1/transactions/{reference}/webhooks/receiver`

## Request

- Base URL: `https://idaas.yourflexpay.com/api`
- URL: `https://idaas.yourflexpay.com/api/v1/transactions/{reference}/webhooks/receiver`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api/docs/v1/transactions/:reference/webhooks/receiver/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the outbound webhook record for the receiving application (TRANSACTION_INITIATED notification).

## Path parameters

- `reference` string, required

## Response `200`

Webhook record found

- ApiResponseTransactionWebhookResponse
  - `success` boolean
  - `message` string
  - `errorCode` string
  - `data` TransactionWebhookResponse: Outbound webhook delivery record for a transaction
    - `id` string, uuid: Unique webhook record ID
    - `transactionId` string, uuid: UUID of the parent transaction
    - `transactionReference` string: Transaction reference
    - `applicationId` string, uuid: UUID of the target application (receiver or sender)
    - `applicationName` string: Name of the target application
    - `direction` 'RECEIVER' | 'SENDER': Which side this webhook notifies
    - `targetUrl` string: HTTP endpoint that was (or will be) called
    - `eventType` 'TRANSACTION_INITIATED' | 'TRANSACTION_COMPLETED' | 'TRANSACTION_REJECTED' | 'TRANSACTION_EXPIRED': Event name included in the webhook body
    - `status` 'PENDING' | 'DELIVERED' | 'FAILED': Current delivery status
    - `attempts` integer: Total number of HTTP delivery attempts made (max 3)
    - `lastError` string: HTTP status code or exception message from the most recent attempt
    - `lastAttemptAt` string, date-time: ISO-8601 timestamp of the most recent delivery attempt
    - `deliveredAt` string, date-time: ISO-8601 timestamp when delivery was confirmed (HTTP 2xx). Null until delivered.
    - `createdAt` string, date-time: ISO-8601 creation timestamp (when the webhook was first queued)
    - `updatedAt` string, date-time: ISO-8601 last-update timestamp
  - `errors` string[]
  - `timestamp` string, date-time

## Other responses

- `404`: Transaction or webhook record not found

## Changes

- **2026-04-17** `db1f954badfb`: 2 info
  - added the optional property `errorCode` to the response with the `200` status
  - added the optional property `errorCode` to the response with the `404` status

[Operation history](https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api/changes/v1/transactions/:reference/webhooks/receiver/get.md)

---

[API](https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api.md) - [All operations](https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api/revisions/db1f954badfb?raw)