> ## Documentation Index
> Fetch the complete documentation index at: https://docs.govfiles.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Ownership matching overview

> Resolve local businesses to their legal owners and operators

Submit physical business locations and GovFiles will match each one to its legal operator, registration, published principals, and available people records.

The asynchronous workflow uses two endpoints:

1. [Create a batch](/api-reference/endpoints/create-local-business-batch) of 1–500 locations.
2. [Poll the batch](/api-reference/endpoints/get-local-business-batch) until it is `succeeded` or `failed`.

The polling endpoint returns the complete result document in its `result` field when the
batch succeeds. There is no separate result-download endpoint.

```bash theme={null}
curl -s -X POST 'https://api.govfiles.dev/v2/local-businesses/batches' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $GOVFILES_API_KEY" \
  -d '{
    "locations": [{
      "customer_record_id": "location-123",
      "name": "Example Kitchen",
      "address": "105 Paramount Park Drive, Gaithersburg, MD 20879"
    }]
  }'
```

Every location must include `name` and `address`. You may optionally provide `phone`, `email`, and `website` to improve matching.
`customer_record_id` is optional: when omitted or `null`, GovFiles generates one and
returns it with the result. Every matched and unmatched result also echoes the submitted
restaurant, so generated IDs remain attributable to the original location.

Rows returning at least one person cost 15 credits. Rows with no people and status
polling are free.