v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Entities (Banking Connectivity)

Update Entity (Banking Connectivity)

patch/banking/entities/{entity_id}

Path parameters

entity_idstring required

The id of the entity obtained from Create Entity.

Request body

account_idstring required

The unique identifier of the merchant's Yuno account (UUID, 36 characters).

merchant_entity_idstring

The merchant's own identifier for this entity.

Example request

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "merchant_entity_id": "merchant_user_12345",
  "phone": {
    "country_code": "+1",
    "number": "2025559999"
  },
  "address": {
    "address_line_1": "456 Oak Ave",
    "address_line_2": "Suite 100",
    "building_number_1": "456",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "country": "US"
  },
  "entity_detail": {
    "individual": {
      "email": "john.new@example.com",
      "country_of_residence": "US"
    },
    "entity": {
      "name": "Acme Corp LLC"
    }
  }
}

Response

idstring

The unique identifier of the entity (prefixed ent_).

account_idstring

The merchant's Yuno account identifier.

merchant_entity_idstring

The merchant's own identifier for this entity.

national_entity'INDIVIDUAL' | 'ENTITY'

The type of entity.

created_atstring

The timestamp when the entity was created (ISO 8601).

updated_atstring

The timestamp when the entity was last updated (ISO 8601).

Example response

{
  "id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "merchant_entity_id": "merchant_user_12345",
  "national_entity": "INDIVIDUAL",
  "phone": {
    "country_code": "+1",
    "number": "2025559999"
  },
  "address": {
    "address_line_1": "456 Oak Ave",
    "address_line_2": "Suite 100",
    "building_number_1": "456",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "country": "US"
  },
  "entity_detail": {
    "individual": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.new@example.com",
      "date_of_birth": "1990-01-15",
      "gender": "M",
      "country_of_residence": "US",
      "tax_information": [
        {
          "country": "US",
          "tax_id_last_4": "6789",
          "tax_id_type": "SSN",
          "is_primary": true
        }
      ],
      "document": {
        "document_type": "SSN",
        "document_number_last_4": "6789",
        "issuing_country": "US",
        "issued_at": "2010-01-15",
        "expires_at": "2030-01-15"
      }
    }
  },
  "created_at": "2026-02-01T10:00:00Z",
  "updated_at": "2026-02-01T12:00:00Z"
}