---
title: "Verify a company for payment"
method: POST
path: "/v1/erp/payouts/payables/verify_company"
tags: ["Payable"]
---

# Verify a company for payment

`POST /v1/erp/payouts/payables/verify_company`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/erp/payouts/payables/verify_company`
- Auth: none required

Looks up a company by id and returns its public identity plus whether it requires a
refund document. Used by the (unauthenticated) refund/payment flow to confirm the
counterpart company before continuing.

This endpoint skips user authentication and identifies the company via the `company_id`
field in the request, not the `company-id` header.

## Request body

- object
  - `company_id` string, uuid, required: The id of the company to verify.

## Response `200`

Company identity and refund-document requirement.

- object
  - `id` string, uuid
  - `name` string
  - `requires_refund_document` boolean

## Other responses

- `404`: Company not found

---

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