Asset Query

Endpoints to query assets inserted in an assignment batch. There are two query modes: paginated listing of all assets in a batch, and individual retrieval of a specific asset.

When to use

Use these endpoints to track asset statuses after insertion, verify which were approved or denied in eligibility, and check denial reasons when applicable.

Asset Listing

Returns the paginated list of all assets in a batch.

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets

METHOD

GET

Query params

Parameter	Type	Required	Description
page	integer	optional	Page number (starts at 0). Default: 0.
limit	integer	optional	Number of records per page. Default: 10.

Example call

GET /trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets?page=0&limit=10

Response

STATUS

200

Response Body

{
    "data": [
        {
            "asset_key": "f4348106-01c4-4c59-a261-7c09db811c47",
            "external_id": "e292656f-f7fb-44dc-96f3-667c36c88442",
            "total_purchase_value": 1231.21,
            "asset_type": "duplicata_mercantil",
            "status": "denied",
            "duration": 9177,
            "denied_by": "document",
            "denial_reason": "Invalid documents"
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Response attributes

Field	Type	Description
data	array	List of asset objects. See table below.
page	integer	Current page number.
limit	integer	Number of records per page.
is_last_page	boolean	Indicates whether this is the last page of results.

Attributes of each asset (objects within data)

Field	Type	Description
asset_key	string	Unique asset identifier (UUID).
external_id	string	External key provided by the partner at creation.
total_purchase_value	number	Total asset purchase value.
asset_type	string	Asset type (e.g., ccb, duplicata_mercantil, discounted_contract).
status	string	Current asset status. See the status enumerators table below.
duration	integer	Asset duration in days. May not be present if not yet calculated.
denied_by	string	Indicates the source of denial (e.g., document, eligibility). Present only when the asset was denied.
denial_reason	string	Description of the denial reason. Present only when the asset was denied.

Nested objects

Depending on the asset type, the response will include the credit_operation object (for CCBs) or discounted_credit_right object (for invoices and discounted contracts) with all credit operation data.

Individual Asset Retrieval

Returns the complete data of a specific asset from the batch.

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset/{asset_external_id}

METHOD

GET

Path params

Parameter	Type	Description
asset_external_id	string	The external_id provided at asset creation.

Response

STATUS

200

Response Body

{
    "asset_key": "074f8786-447f-4524-9f4f-a5cf8a890bb4",
    "external_id": "acfbc329-4e67-40ea-bd8d-5debdaebe144",
    "total_purchase_value": 1231.21,
    "asset_type": "duplicata_mercantil",
    "status": "denied",
    "duration": 9184,
    "denied_by": "document",
    "denial_reason": "Invalid documents"
}

Response attributes

The response has the same structure as each object in the data array returned by the asset listing, plus the complete credit operation object (credit_operation or discounted_credit_right, depending on the asset type).

Asset status enumerators

Status	Description
pending_eligibility	Asset inserted, awaiting eligibility analysis.
pre_approved	Asset pre-approved in individual eligibility.
pending_documentation	Asset approved in eligibility, awaiting document submission.
approved	Asset approved with validated documentation.
denied	Asset denied in eligibility or document validation.
discarded	Asset discarded from the batch.