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

# Delete sender

> Delete a sender by its `snd_` reference id. Returns the sender object as it was before deletion. Later reads of that id fail.

## POBO error codes

| Code | HTTP | When |
| - | - | - |
| `ERRTXN_1000` | `400` | `senderId` missing on pre-transaction or submit. |
| `ERRTXN_1001` | `400` | The route is not served by Paywho. |
| `ERRTXN_1002` | `400` | `walletId` missing on a wallet-funded transfer. |
| `ERRTXN_1003` | `400` | `walletId` not found or not active. |
| `ERRQUO_1000` | `404` | Quote not found. |
| `ERRQUO_1017` | `400` | No rate available for this route. |
| `ERRQUO_1019` | `400` | `senderType` or `recipientType` is not `INDIVIDUAL` / `BUSINESS`. |
| `ERRREC_1000` | `404` | Recipient not found. |
| `ERRREF_1000` / `ERRREF_1001` | `400` / `404` | Malformed / unknown reference id. |
| `ERRCORE_1001` | `400` | Sender validation failures, including `Sender not found`. |
| `ERRCORE_1003` | `409` | A live sender already has this `governmentId`. |
| `ERRCORE_1005` | `403` | The API key lacks the `pobo` permission. |

Branch on `errors[0].code`. See [Error codes](https://docs.endl.io/api-reference/error-codes.md) for every code.


## OpenAPI

````yaml api-reference/endl-pobo-api.json DELETE /api/v0/pobo/senders/{senderId}
openapi: 3.1.0
info:
  title: Endl POBO API
  version: '0'
  description: >-
    Payment on behalf of — pay out on behalf of a named originator.


    Every POBO endpoint lives under `/api/v0/pobo` and needs an API key carrying
    the `pobo` permission. POBO is **partner-scoped**: there is no `userId` in
    any path, and every identifier you exchange is a prefixed reference id
    rather than an internal UUID.


    POBO routes through Paywho only. A Bridge-routed currency or rail is
    rejected with `400 ERRTXN_1001`. Success bodies are unwrapped; `userId` and
    `ownerUserId` are never returned.
servers:
  - url: https://api-sandbox.endl.io
    description: Sandbox
security:
  - apiKey: []
paths:
  /api/v0/pobo/senders/{senderId}:
    delete:
      tags:
        - Senders
      summary: Delete sender
      description: >-
        Delete a sender by its `snd_` reference id. Returns the sender object as
        it was before deletion. Later reads of that id fail.
      parameters:
        - $ref: '#/components/parameters/ApiVersion'
        - name: senderId
          in: path
          required: true
          schema:
            type: string
          description: The sender reference id.
          example: snd_xxxxxxxxxxxxxxxxxxxx
      responses:
        '200':
          description: The sender as it was before deletion. **Unwrapped.**
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Sender'
              example:
                id: snd_9Bv2Lq7Rk4Xn1Pz6Tm3W
                type: BUSINESS
                firstName: Acme Trading Pte Ltd
                lastName: null
                businessName: Acme Trading Pte Ltd
                email: finance@acmetrading.sg
                phone: '+6567890123'
                governmentId: 201912345K
                governmentIdType: BUSINESS_REGISTRATION
                governmentIdIssueCountry: SGP
                nationality: SGP
                occupation: null
                gender: null
                sourceOfFunds: BUSINESS_INCOME
                remark: Supplier payments
                governmentIdIssueDate: null
                governmentIdExpiryDate: null
                businessRegistrationNumber: 201912345K
                incorporationDate: 02-05-2019
                businessRegistrationCountry: SGP
                businessStructure: Pte Ltd.
                relationshipToCustomer: SUPPLIER
        '400':
          description: Validation failed, or the route is not supported for POBO.
          content:
            application/json:
              example:
                code: 400
                message: Rail not supported for POBO
                status: ERROR
                data: null
                errors:
                  - code: ERRTXN_1001
                    message: Rail not supported for POBO
                    field: null
        '401':
          description: Missing or invalid API credentials.
          content:
            application/json:
              example:
                data: null
                code: 401
                message: Authentication Failed!
                status: Error
                errors:
                  - code: '401'
                    message: Authentication Failed!
                    field: Authentication Failed!
        '403':
          description: The key does not carry the `pobo` permission. Raised at the edge.
          content:
            application/json:
              example:
                data: null
                code: 403
                message: API key does not have 'pobo' permission
                status: Error
                errors:
                  - code: '403'
                    message: API key does not have 'pobo' permission
                    field: API key does not have 'pobo' permission
        '404':
          description: No such resource, or it belongs to another partner.
          content:
            application/json:
              example:
                code: 404
                message: Resource not found
                status: ERROR
                data: null
                errors:
                  - code: NOT_FOUND
                    message: Resource not found
                    field: null
        '429':
          description: The per-API-key request rate limit was exceeded.
          content:
            application/json:
              example:
                data: null
                code: 429
                message: Rate limit exceeded, please retry later
                status: Error
                errors:
                  - code: '429'
                    message: Rate limit exceeded, please retry later
                    field: Rate limit exceeded, please retry later
        '500':
          description: Unexpected server error.
          content:
            application/json:
              example:
                code: 500
                message: Unexpected error
                status: ERROR
                data: null
                errors:
                  - code: INTERNAL_ERROR
                    message: Unexpected error
                    field: null
        '502':
          description: >-
            Endl could not reach the service behind the edge. Retry with
            backoff.
          content:
            application/json:
              example:
                data: null
                code: 502
                message: Upstream service error
                status: Error
                errors: null
components:
  parameters:
    ApiVersion:
      name: Api-Version
      in: header
      required: true
      description: >-
        The API version this request targets. Required on every `/api/v0/*`
        call. Format `YYYY-MM.<release>`; `2026-09.1` is the latest. The version
        that served the request is echoed back on the response. Missing,
        malformed or unsupported values are rejected with `400`.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}\.\d+$
        default: 2026-09.1
      example: 2026-09.1
  schemas:
    Sender:
      type: object
      description: >-
        A POBO sender, unwrapped. All keys are always present; unset values are
        `null`. There is no sender status, and `dateOfBirth` and `address` are
        stored but not returned.
      required:
        - id
        - type
        - firstName
        - lastName
        - businessName
        - email
        - phone
        - governmentId
        - governmentIdType
        - governmentIdIssueCountry
        - nationality
        - occupation
        - gender
        - sourceOfFunds
        - remark
        - governmentIdIssueDate
        - governmentIdExpiryDate
        - businessRegistrationNumber
        - incorporationDate
        - businessRegistrationCountry
        - businessStructure
        - relationshipToCustomer
      properties:
        id:
          type: string
          description: >-
            `snd_…` reference id. Pass as `senderId` on pre-transaction and
            submit.
        type:
          type: string
          description: '`INDIVIDUAL` or `BUSINESS`.'
        firstName:
          type: string
          description: First name; for a business, the business name.
        lastName:
          type:
            - string
            - 'null'
          description: Last name. Individuals only.
        businessName:
          type:
            - string
            - 'null'
          description: Business name. `null` for individuals.
        email:
          type:
            - string
            - 'null'
          description: Contact detail.
        phone:
          type:
            - string
            - 'null'
          description: Contact detail.
        governmentId:
          type: string
          description: Identity or registration number. Unique per partner.
        governmentIdType:
          type:
            - string
            - 'null'
          description: Type of that document.
        governmentIdIssueCountry:
          type:
            - string
            - 'null'
          description: Issuing country of that document.
        nationality:
          type:
            - string
            - 'null'
          description: Individual detail.
        occupation:
          type:
            - string
            - 'null'
          description: Individual detail.
        gender:
          type:
            - string
            - 'null'
          description: Individual detail. `M` or `F`.
        sourceOfFunds:
          type:
            - string
            - 'null'
          description: Source-of-funds code.
        remark:
          type:
            - string
            - 'null'
          description: Free text.
        governmentIdIssueDate:
          type:
            - string
            - 'null'
          description: '`DD-MM-YYYY`.'
        governmentIdExpiryDate:
          type:
            - string
            - 'null'
          description: '`DD-MM-YYYY`.'
        businessRegistrationNumber:
          type:
            - string
            - 'null'
          description: Business only; `null` for individuals.
        incorporationDate:
          type:
            - string
            - 'null'
          description: Business only; `DD-MM-YYYY`.
        businessRegistrationCountry:
          type:
            - string
            - 'null'
          description: Business only; `null` for individuals.
        businessStructure:
          type:
            - string
            - 'null'
          description: Business only; `null` for individuals.
        relationshipToCustomer:
          type:
            - string
            - 'null'
          description: e.g. `CUSTOMER`, `SUPPLIER`, `EMPLOYEE`.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: API-KEY
      description: Your partner API key. Must carry the `pobo` permission.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.