Update US Counterparty

This endpoint updates an existing US counterparty.

Authorization:

bearer

HTTP: bearer

HTTP Authorization Scheme: bearer

Headers:
  Authorization: APIKey {YOUR_API_KEY}

Endpoint

PUT

/api/v2/banking/counterparties/{id}

Path Parameters

Parameter	Type	Description
id	string (uuid)	Required. The counterparty ID to update.

Request Body Sample

{
  "counterpartyName": "John Smith Updated",
  "address": {
    "address1": "456 Broadway",
    "city": "Los Angeles",
    "state": "CA",
    "postalCode": "90001",
    "country": "US"
  },
  "accountNumber": "987654321",
  "routingNumber": "021000021",
  "bankName": "Bank of America",
  "type": "individual",
  "instrumentType": "wire",
  "wireType": "domestic",
  "bankAddress": {
    "address1": "100 N Tryon St",
    "city": "Charlotte",
    "state": "NC",
    "postalCode": "28202",
    "country": "US"
  }
}

Request Body Schema

Field	Type	Description
counterpartyName	string	Required. Counterparty name. Min 2, max 255 characters.
address	object	Required. Counterparty's address.
instrumentType	string	Required. Payment instrument type. Values: ach, wire.
wireType	string	Required when instrumentType is wire. Values: domestic, international.
accountNumber	string	Bank account number. 4-17 characters.
routingNumber	string	Bank routing number. Exactly 9 characters.
swiftCode	string	SWIFT/BIC code. 8-11 characters.
iban	string	IBAN. 15-34 characters.
bankName	string	Required. Bank name. Min 2, max 255 characters.
type	string	Optional. Counterparty type. Values: individual, business.
bankAddress	object	Optional. Bank's address. Same schema as address.

Payment Type Requirements

Type	Required Fields
ACH (instrumentType: "ach")	routingNumber + accountNumber
Domestic Wire (instrumentType: "wire", wireType: "domestic")	routingNumber + accountNumber
International Wire (instrumentType: "wire", wireType: "international")	routingNumber + swiftCode + (accountNumber or iban)

Response Sample

{
  "id": "00000000-0000-0000-0000-000000000000",
  "accountId": "00000000-0000-0000-0000-000000000000",
  "reference": "US-VENDOR-001",
  "currency": "USD",
  "counterpartyName": "John Smith Updated",
  "address": {
    "address1": "456 Broadway",
    "city": "Los Angeles",
    "state": "CA",
    "postalCode": "90001",
    "country": "US"
  },
  "accountNumber": "987654321",
  "routingNumber": "021000021",
  "swiftCode": "",
  "iban": "",
  "bankName": "Bank of America",
  "type": "individual",
  "instrumentType": "wire",
  "wireType": "domestic",
  "bankAddress": {
    "address1": "100 N Tryon St",
    "city": "Charlotte",
    "state": "NC",
    "postalCode": "28202",
    "country": "US"
  },
  "status": "active",
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-01-02T00:00:00Z"
}

Support and Resources

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

• Instagram: BlockWyre Instagram
• Twitter: BlockWyre Twitter
• Facebook: BlockWyre Facebook
• LinkedIn: BlockWyre LinkedIn

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!