Get BR profile
Fetch the user's banking profile, including IBAN, fiat limits, contacts, deposit bank details, and card eligibility. Limits are denominated in CHF over a rolling 30-day window. The EUR/CHF IBAN receives EUR and CHF deposits only; a USD IBAN is provisioned separately via POST /v1/apply-usd-payin and then appears under the USD key of depositBank.
Partner Auth: EIP-191 signature by the partner's registered backend key, with X-Api-Deadline and optional X-Api-PublicKey headers. See the Signature and verify guide.
0x-prefixed 65-byte hex EIP-191 signature over the Partner Auth message. See the Signature and verify guide.
Unix seconds. UR rejects the request when the current time is past the deadline. Keep the validity window at or under 5 minutes.
0x-prefixed partner signer address registered with UR.
Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.
Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.
Standard envelope. Business errors return HTTP 200 with a non-zero code.
Standard UR OpenAPI response envelope. code 0 means success; a non-zero code is a business error described by message.
0 on success; non-zero business error code.
Human-readable explanation. May be empty on success.
GET /api/fma/v1/br HTTP/1.1
Host: openapi.ur.app
X-Api-Signature: text
X-Api-Deadline: text
X-Api-PublicKey: text
Accept: */*
Standard envelope. Business errors return HTTP 200 with a non-zero code.
{
"code": 0,
"message": "",
"data": {
"tokenId": 1000123456,
"br": "John Doe",
"iban": "CH9300762011623852957",
"email": "john@example.com",
"mobile": "+41xxxx",
"debitCard": "MSTD",
"isCardEligible": true,
"cards": [],
"cardActivation": {
"amount": 100,
"currency": "CHF"
},
"street": "Bahnhofstrasse 1",
"postalCode": "8001",
"city": "Zurich",
"country": "CHE",
"limits": {
"restartDate": "2026-04-30",
"restartDateMs": 1777507200000,
"used": 10000,
"available": 90000,
"max": 100000
},
"contacts": {
"EUR": [
{
"id": "cnt_001",
"name": "Acme SA",
"account": "CH93****2957",
"fullAccount": "CH9300762011623852957",
"bank": "UBS",
"country": "CH",
"lastPaymentDate": 1713600000000
}
]
},
"depositBank": {
"EUR": {
"account": "CHxx...",
"bank": "Bank ABC",
"BIC": "FNBSCHZZXXX",
"payee": "UR AG",
"city": "Zurich",
"street": "xxxxx",
"postalCode": "8001",
"country": "CH"
}
}
}
}Last updated