---
title: "Update a Receiver"
method: PATCH
path: "/receivers/{id}"
tags: ["Receivers"]
---

# Update a Receiver

`PATCH /receivers/{id}`

This endpoint allows an organization to add and update information on the receiver, including email address, external ID, date of birth, personal PIN, and national ID number. The response includes all information on the receiver.

## Path parameters

- `id` string, required

## Response `200`

Updated Receiver Details

- Receiver
  - `id` string
  - `phone_number` string
  - `external_id` string
  - `email` string
  - `created_at` string
  - `total_payments` string
  - `successful_payments` string
  - `failed_payments` string
  - `remaining_payments` string
  - `registered_wallets` string
  - `received_amounts` Amount[]
    - `asset_code` string
    - `asset_issuer` string
    - `received_amount` string
  - `wallets` ReceiverWallet[]
    - `id` string
    - `receiver` ReceiverLite
      - `id` string
    - `wallet` WalletLite
      - `id` string
      - `name` string
      - `homepage` string
      - `sep_10_client_domain` string
      - `deep_link_schema` string
      - `enabled` boolean
      - `user_managed` boolean
    - `stellar_address` string
    - `stellar_memo` string
    - `stellar_memo_type` string
    - `created_at` string
    - `updated_at` string
    - `invited_at` string
    - `last_message_sent_at` string — timestamp when the receiver last received an invitation about this wallet
    - `total_payments` string
    - `payments_received` string
    - `failed_payments` string
    - `remaining_payments` string
    - `received_amounts` Amount[]
      - `asset_code` string
      - `asset_issuer` string
      - `received_amount` string
    - `status` 'DRAFT' | 'READY' | 'REGISTERED' | 'FLAGGED'
    - `status_history` ReceiversWalletStatusHistoryEntry[]
      - `status` 'DRAFT' | 'READY' | 'REGISTERED' | 'FLAGGED'
      - `timestamp` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflicting phone number or email

## Changes

- **2026-01-08** `b6f8a6e65559` — 4 info
  - added the optional property `wallets/items/wallet/deep_link_schema` to the response with the `200` status
  - added the optional property `wallets/items/wallet/enabled` to the response with the `200` status
  - added the optional property `wallets/items/wallet/sep_10_client_domain` to the response with the `200` status
  - added the optional property `wallets/items/wallet/user_managed` to the response with the `200` status
- **2024-12-02** `2b94ab613474` — 1 warning, 4 info
  - removed the optional property `wallets/items/last_sms_sent` from the response with the `200` status
  - api operation id `UpdateAReceiver` removed and replaced with `UpdateReceiver`
  - added the new optional request property `phone_number`
  - added the non-success response with the status `409`
  - …1 more

[Change history](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api/changes/receivers/:id/patch.md)

---

[API](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/revisions/39f9dc64156c/schema)