# NameGender Batches API

**Canonical:** https://apis.io/apis/namegender/namegender-batches-api/  
**Provider:** NameGender — https://apis.io/providers/namegender/  
**Base URL:** https://namegender.com  
**Documentation:** https://namegender.com/docs

NameGender Batches API is one of 4 APIs that [NameGender](https://apis.io/providers/namegender/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Batches. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Upload a CSV or XLSX file and download it back with gender columns added.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/batches` | Upload a file and start processing it |
| GET | `/api/v1/batches` | List file jobs |
| GET | `/api/v1/batches/{batch}` | Status of a file job |
| DELETE | `/api/v1/batches/{batch}` | Cancel or delete a file job |
| GET | `/api/v1/batches/{batch}/result` | Download the result file |
| POST | `/api/v1/batches/{batch}/start` | Start a job uploaded with start=false |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/openapi/namegender-batches-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-countries-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-batch-job-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-bulk-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-bulk-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-account-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/namegender/refs/heads/main/json-schema/namegender-single-response-schema.json

## Other NameGender APIs (3)

- [NameGender Account API](https://apis.io/apis/namegender/namegender-account-api/)
- [NameGender Gender API](https://apis.io/apis/namegender/namegender-gender-api/)
- [NameGender Webhooks API](https://apis.io/apis/namegender/namegender-webhooks-api/)

## Tags

Batches

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/namegender/namegender-batches-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/namegender/.