Invalid V4 Account-id error (Personal Accounts API)

Q:

What could be the reason of the following error ("code": "error.validation", "description": "Invalid V4 Account-id", "path": "id")?

{
"group_header": {
"message_identification": "2b1f3d711527165e",
"creation_date_time": "2024-11-21T08:50:11.635235805Z",
"http_code": 400
},
"error": {
"request": {
"url": "/v5/accounts/id-v4-to-v5/FINOQqJXir{redacted}nEwMl4DyAztU"
},
"failures": [
{
"code": "error.validation",
"description": "Invalid V4 Account-id",
"path": "id"
}

A:

Make sure you use the conversion properly.

• Endpoint:

GET /personal/v5/accounts/id-v4-to-v5/{id}

is used to mask the account identifier:

• • Proper usage: "url": "/v5/accounts/id-v4-to-v5/FIXXXXXXXXXXXXX-EUR"
  • Wrong usage: "url": "/v5/accounts/id-v4-to-v5/FINOQqJXir{redacted}nEwMl4DyAztU"

• Endpoint:

GET /personal/v5/accounts/id-v5-to-v4/{id}

is used to unmask the account identifier:

• • Proper usage: "url": "/v5/accounts/id-v5-to-v4/FINOQqJXir{redacted}nEwMl4DyAztU"
  • Wrong usage: "url": "/v5/accounts/id-v5-to-v4/FIXXXXXXXXXXXXX-EUR"