Get account holdings valuation

Returns the cached fund holdings valuation for one or more PSP account numbers.

Accounts outside your range

An account number outside your assigned block comes back as an error entry inside a 200 response, not as a request-level failure. Read the per-account entries, not just the status code.

Allaria reserves that contiguous block of account numbers for your integration when it is set up — see Overview.

POST/v1/psp/tenencia-val

Request

Headers

Field	Type	Required	Description
Authorization	string	Yes	Access token in Bearer ACCESS_TOKEN format
Content-Type	string	Yes	Must be application/json

Not applicable: Path Parameters, Query Parameters.

Body

Field	Type	Required	Description
cuentas	number[]	Yes	Account numbers to query

Response

2XX Success

Field	Type	Description
cuenta	number	Account number
fondo	string	Fund code
cantidad	number	Number of shares
precio	number	Current share price
valuacion	number	Position valuation
error	string	Present when the account cannot be queried

Error Codes

Status	Description
400	Missing or invalid cuentas payload
401	Unauthorized - invalid or missing access token
403	Forbidden - the token does not have permission to access this resource

Code Example

cURL

curl -X POST "https://b2b.allaria.dev/v1/psp/tenencia-val" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cuentas": [300000001, 300000002]
  }'

2XX Success

[
  {
    "cuenta": 300000001,
    "fondo": "ALAHORA:AR",
    "cantidad": 10.25,
    "precio": 81.893806,
    "valuacion": 839.61
  },
  {
    "cuenta": 399999999,
    "error": "Cuenta errónea"
  }
]