# searchOpenPaymentsCompanies

**Identifier:** `openpayments_searchOpenPaymentsCompanies`

**Provider:** [OpenPayments](https://kirha.com/providers/openpayments.md)

Find drug/device manufacturers and GPOs reporting to CMS Open Payments (US Sunshine Act) by name, ranked by total payments since 2019. Returns the companyId needed by getCompanyPaymentSummary, getTopPaymentRecipients and searchResearchPayments. Large groups report under several entities (e.g. 'Pfizer Inc.' vs 'Pfizer Laboratories').

## Run it with the CLI

```bash
kirha tools run openpayments_searchOpenPaymentsCompanies \
  --input '{
    "companyName": "Pfizer"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "openpayments_searchOpenPaymentsCompanies",
  "input": {
    "companyName": "Pfizer"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "companyName": {
      "description": "e.g. Pfizer, Medtronic, Johnson",
      "minLength": 2,
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "companyName"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "companies": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "alternateNames": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "companyId": {
            "description": "Open Payments AMGPO ID",
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "generalPaymentsUsd": {
            "description": "All program years combined",
            "type": "number"
          },
          "generalTransactions": {
            "type": "number"
          },
          "ownershipInvestmentUsd": {
            "type": "number"
          },
          "researchPaymentsUsd": {
            "type": "number"
          },
          "researchTransactions": {
            "type": "number"
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "companyId",
          "companyName",
          "generalPaymentsUsd",
          "researchPaymentsUsd",
          "ownershipInvestmentUsd",
          "generalTransactions",
          "researchTransactions"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "companyIds": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    }
  },
  "required": [
    "context",
    "companies",
    "companyIds"
  ],
  "type": "object"
}
```

## Related tools

Other OpenPayments tools that this tool refers to, or that refer to it.

- [`getTopPaymentRecipients`](https://kirha.com/providers/openpayments/getTopPaymentRecipients.md)
- [`searchResearchPayments`](https://kirha.com/providers/openpayments/searchResearchPayments.md)
- [`getCompanyPaymentSummary`](https://kirha.com/providers/openpayments/getCompanyPaymentSummary.md)

-----

[All OpenPayments tools](https://kirha.com/providers/openpayments.md) · [< Back to tools list](https://kirha.com/tools.md)