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/get-by-id.md.
  • English

    • Get movement by ID

    Generated from the Finity OpenAPI specification.

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

    Movements

    GET/v0/movements/{id}

    Get movement by ID

    Retrieve a specific movement by its identifier.

    Bearer token required

    Request

    NameLocationTypeRequiredExample
    idExternal identifier of the movementpathstringYesmvm-76da-30eb-4c1c-b89c-679cd57b6f05

    Responses

    200Movement retrieved successfully
    id: string
type: CURRENCY_EXCHANGE | COP_WITHDRAWAL | FUNDS_DEPOSIT | CARD_PURCHASE
status: pending | processing | completed | failed
currency: string
origin_amount: number
destination_amount: number
destination_currency: string
destination_account: object
  id: string
  bank_name: string
  type: string
  account_number: string
  account_holder_id_type: string
  account_holder_id_number: string
  account_holder_fullname: string
created_at: string (date-time)
updated_at: string (date-time)
    401Unauthorized – missing or invalid authentication token
    statusCode: integer
message: string
error: string
    403Forbidden – insufficient permissions
    statusCode: integer
message: string
error: string
    404Movement not found
    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/{id}
    Generated Shell requestReady to copy
    curl -X GET \
  'https://api2.finity.com.co/v0/movements/{id}' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'