List Counterparties

Get a list of all your buyers and suppliers

You can immediately get a full list of your buyers and suppliers that you previously created by using the List Counterparties endpoint (https://stage.api.finexio.com/v2/counterparties/).

This list can be narrowed down to a specific page with Pagination. A maximum of 100 objects can be returned per page.

You can also search for counterparties updated after a specific date. Use an ISO 8601 formatted date to list counterparties updated since the supplied date.

A sample response looks as follows:

{
    "count": 4,
    "next": null,
    "previous": null,
    "results": [
     {
            "id": "0b575520-d4fc-47a5-a27a-7b2c062e075f",
            "name": "FinexioTest1",
            "type": "Buyer",
            "created": "2023-03-14T13:52:12.929815",
            "updated": "2023-03-14T13:52:13.267218",
            "address_1": null,
            "address_2": null,
            "city": null,
            "state": null,
            "zipcode": null,
            "country": "USA",
            "primary_contact_email": null,
            "remit_email": null,
            "primary_contact_name": null,
            "primary_contact_phone": null,
            "bank_account_number": null,
            "bank_routing_number": null,
            "payment_method": "",
            "internal_id": "Example1",
            "payment_terms": null,
            "tax_id": null,
            "notes": null
        },
        {
            "id": "66449894-e0f4-4193-8d23-88c3526920bb",
            "name": "FinexioTest2",
            "type": "Buyer",
            "created": "2023-03-14T13:52:12.929815",
            "updated": "2023-03-14T13:52:13.279669",
            "address_1": null,
            "address_2": null,
            "city": null,
            "state": null,
            "zipcode": null,
            "country": "USA",
            "primary_contact_email": null,
            "remit_email": null,
            "primary_contact_name": null,
            "primary_contact_phone": null,
            "bank_account_number": null,
            "bank_routing_number": null,
            "payment_method": "",
            "internal_id": "Example2",
            "payment_terms": null,
            "tax_id": null,
            "notes": null
        },
        {
            "id": "2c87f559-a0c7-4526-8dbc-77e06f2bc8d6",
            "name": "Acme Co.",
            "type": "Supplier",
            "created": "2023-03-14T13:52:12.929815",
            "updated": "2023-03-15T21:12:12.776580",
            "address_1": "4000 Warner Boulevard",
            "address_2": null,
            "city": "Burbank",
            "state": "CA",
            "zipcode": "91505",
            "country": "USA",
            "primary_contact_email": "[email protected]",
            "remit_email": null,
            "primary_contact_name": null,
            "primary_contact_phone": null,
            "bank_account_number": null,
            "bank_routing_number": null,
            "payment_method": "PrintedCheck",
            "internal_id": "ACME",
            "twelve_month_spend": null,
            "twelve_month_payment_count": null,
            "payment_terms": null,
            "tax_id": "123-12-1238",
            "ineligible_for_conversion": false,
            "business_type": null,
            "notes": null
        },
        {
            "id": "b1d5a7e8-62fa-4e38-93bf-6be23bdefa82",
            "name": "Tires Supply",
            "type": "Supplier",
            "created": "2023-03-21T22:27:20.975073",
            "updated": "2023-03-21T22:27:20.975095",
            "address_1": "123 Main St.",
            "address_2": null,
            "city": "Orlando",
            "state": "FL",
            "zipcode": "32817",
            "country": "USA",
            "primary_contact_email": "[email protected]",
            "remit_email": "[email protected]",
            "primary_contact_name": "Tires Supply",
            "primary_contact_phone": "407-555-1212",
            "bank_account_number": "123456789",
            "bank_routing_number": "021000021",
            "payment_method": "PrintedCheck",
            "internal_id": "TIRESSUPPLY",
            "twelve_month_spend": 10,
            "twelve_month_payment_count": "80.00",
            "payment_terms": 30,
            "tax_id": "123-12-2222",
            "ineligible_for_conversion": false,
            "business_type": "Business",
            "notes": "Enter any additional information about your supplier"
}
    ]
}