For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /api/movements/list.md.
  • English

    • Get movements with filters and pagination

    Generated from the Finity OpenAPI specification.

    Base URLhttps://api2.finity.com.co

    Movements

    GET/v0/movements

    Get movements with filters and pagination

    Retrieve a paginated list of movements with optional filtering by status, asset, and movement type.

    Bearer token required

    Request

    NameLocationTypeRequiredExample
    statusMovement status filterquerypending | processing | completed | failedNocompleted
    assetAsset type filterquerystringNoUSD
    movement_typeMovement type filterqueryCURRENCY_EXCHANGE | COP_WITHDRAWAL | FUNDS_DEPOSIT | CARD_PURCHASENoCURRENCY_EXCHANGE
    pagePage numberqueryintegerNo1
    limitNumber of items per pagequeryintegerNo10

    Responses

    200List of movements retrieved successfully
    total_items: integer
total_pages: integer
is_last_page: boolean
page_items: integer
contents: object[]
    401Unauthorized – missing or invalid authentication token
    statusCode: integer
message: string
error: string
    403Forbidden – insufficient permissions
    statusCode: integer
message: string
error: string

    Try it live

    Live request

    Try this endpoint

    Configure the request and send it directly to the Finity API.

    GET
    Code language

    Authentication

    Use a Bearer token to authorize this request.

    Optional

    Parameters

    Provide the values required by this endpoint.

    Request URLProduction
    GEThttps://api2.finity.com.co/v0/movements?status=completed&asset=USD&movement_type=CURRENCY_EXCHANGE&page=1&limit=10
    Generated Shell requestReady to copy
    curl -X GET \
  'https://api2.finity.com.co/v0/movements?status=completed&asset=USD&movement_type=CURRENCY_EXCHANGE&page=1&limit=10' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'