---
title: "Page through the organization's trade parties"
method: POST
path: "/trade-parties/search"
tags: ["Parties"]
---

# Page through the organization's trade parties

`POST /trade-parties/search`

## Request

- Base URL: `https://api.tarifflo.com/api/v2`
- URL: `https://api.tarifflo.com/api/v2/trade-parties/search`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Requires the API key scope `filing`.

## Request body

- object
  - `startRow` number, required
  - `endRow` number, required
  - `searchText` string

## Response `200`

Successful response

- object
  - `rowData` object[], required
    - `id` string, required
    - `legalName` string, required
    - `phone` string, required
    - `address` string, required
    - `error` string
    - `individualContacts` object[]
      - `name` string
      - `phone` string
      - `email` string
      - `role` string
  - `rowCount` number, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/tarifflo/apis/tarifflo-api.md) - [All operations](https://skmtc.dev/tarifflo/apis/tarifflo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tarifflo/apis/tarifflo-api/revisions/f048ebac1ac5?raw)