getneo
    getneo
    • Introduction
    • API examples
    • Technical topics
      • API structure
      • HTTP headers
      • Decoupled responses
      • Validation failures (418)
    • Endpoints
      • Auth
        • Get service bearer token (password)
          GET
        • Change tenant
          GET
        • Close session
          GET
      • Counterparties
        • Get all counterparties
          GET
        • Get counterparty by ID
          GET
        • Get draft counterparty by ID
          GET
        • Submit counterparty draft
          POST
        • Update counterparty draft
          POST
        • Delete a counterparty draft
          DELETE
        • Add account to counterparty
          POST
        • Update counterparty account
          PATCH
        • Export counterparty data
          POST
      • Payments
        • Get all payments
          GET
        • Get a payment by ID
          GET
        • Make a payment (deposit, withdrawal or internal)
          POST
      • Trading
        • Quote order
        • Submit order
      • Wallets
        • Get all wallets
        • Get a wallet by ID
    • Schemas
      • Schemas
        • Components
          • AmountModel
          • AmountModelWithRate
          • BaseableAmountModel
          • CorpModel
          • IbanModel
          • TenantInfo
          • WalletModel
          • WalletLedgerModelV5
          • OrderLegAccount
        • Enums
          • OrderTypes
        • Reference
          • actions
          • bic_swift
          • country
          • currency
          • entity_key
        • Responses
          • CorpWalletModelV2
          • FullIdentityResponse
          • IdentityResponse
        • Forms
          • OrderQuoteForm
        • counterpartyAccountModelV3
        • ibanSlim
        • accountInfo
        • counterpartyAttachmentsResponseModel
        • accountOwnerModel
        • counterpartyModelV3
        • accountSlim
        • intermediaryBankAccountModel
        • addressModel
        • amountSlim
        • commissionResponseModel
        • confirmationDocumentResponseModel
        • counterpartyAccountModelV2
        • counterpartyModelV2
        • forwardRateModel
        • invoiceableAmountModel
        • leg
        • marginResponseModel
        • marketInfoResponseModel
        • markToMarketResponseModel
        • orderPaymentResponseModel
        • orderQuoteResponse
        • orderSettlementResponseModel
        • paymentAccountModel
        • paymentAttachmentsResponseModel
        • paymentBlotterItemModelV2
        • paymentCounterpartyAccountModel
        • paymentCounterpartyModel
        • paymentDestinationModel
        • paymentFeesChargeModel
        • paymentFeeSlim
        • paymentForm
        • paymentItemSlimModel
        • paymentSourceForm
        • paymentSourceModel
        • paymentTrackingSource
        • personModel
        • quotePriceModel
        • rateModel
        • rejectForm
        • reversableRateModel
        • settlementInstructionsModel
        • specifiedPaymentFee
        • swapInfoModel
        • tickPriceModel
        • tickRateModel
        • tradeLimitsModel
      • Response
        • standard-Validation-Failure

    Introduction

    Important
    This documentation is incomplete and is subject to change.
    December 2025
    Please take note we have simplified all URLs to a single domain: api.getneo.com and removed /api from the path.
    Legacy domains will continue to be supported for existing functionality but will be slowly phased out.
    Example: https://auth.getneo.com/api/v1/auth/login is now https://api.getneo.com/v1/auth/login
    This is the technical documentation for using the API of the getneo platform ("Neo").
    Not all APIs are available to every client, based on factors such as contract type. If you wish access to an API that doesn't work for you (most likely responding with a 403 Forbidden status), please contact us to discuss.
    If you have specific questions about any of the content or some missing information, please contact support@getneo.com with your questions.

    Design#

    The platform is provided as a set of HTTP web services, designed using RESTful concepts, with minor customisation to typical flow in order to facilitate better and more secure workflows.
    Due to the structured nature of the data, the API always responds in JSON format unless stated otherwise. Equally, all request bodies are preferred in JSON format, although other standards (i.e., x-www-form-urlencoded) will be accepted, but support is not guaranteed.
    The modifications that are applied throughout the whole platform are described in this documentation.

    Environments#

    Neo provides a Demo and a Production environment.
    This documentation shows both possible URLs, but only the Demo environment can be tested here due to CORS protection.

    Terminology#

    Some Neo-specific terms used throughout the documentation have important meaning.
    Form
    A JSON structure sent in a request.
    Tenant
    The platform account that is currently being accessed. A user can switch context to work across multiple tenants with a single login.
    User
    The currently authenticated user of the platform.

    Entity Ids#

    Every entity in Neo has a unique identifier in the form of a 22-character alpha-numeric string, which will be referred to as "ids" in this documentation.
    Example: PJktaIp1jUiGODbklWBIrA
    Modified at 2025-11-28 09:22:23
    Next
    API examples
    Built with