Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| status | string | |
| source | string | |
| file | object | |
| columns | object | |
| options | object | |
| rows | object | |
| progress | integer | |
| credits | object | |
| summary | objectnull | |
| data_version | stringnull | |
| error | objectnull | Set when `status` is `failed`. Branch on `code`. |
| result | objectnull | |
| inspection | objectnull | Only while `status` is `uploaded`. |
| poll_after_seconds | integernull | |
| created_at | stringnull | |
| started_at | stringnull | |
| finished_at | stringnull | |
| expires_at | stringnull |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/namegender/main/json-schema/namegender-batch-job-schema.json",
"title": "BatchJob",
"x-generated": "2026-10-06",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/_original/namegender-api-openapi.json#/components/schemas/BatchJob",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"uploaded",
"queued",
"processing",
"completed",
"failed",
"cancelled"
]
},
"source": {
"type": "string",
"enum": [
"api",
"panel"
]
},
"file": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"format": {
"type": "string",
"enum": [
"csv",
"xlsx"
]
}
}
},
"columns": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
}
}
},
"options": {
"type": "object",
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"ai_fallback": {
"type": "boolean"
},
"best_guess": {
"type": "boolean"
},
"delete_after_download": {
"type": "boolean"
}
}
},
"rows": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"processed": {
"type": "integer"
},
"identified": {
"type": [
"integer",
"null"
],
"description": "Rows given a gender. Set once completed."
}
}
},
"progress": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"credits": {
"type": "object",
"properties": {
"reserved": {
"type": [
"integer",
"null"
],
"description": "Held from the balance when processing began."
},
"charged": {
"type": [
"integer",
"null"
],
"description": "Final charge. Null until completed; a failed job is not charged."
}
}
},
"summary": {
"type": [
"object",
"null"
],
"properties": {
"male": {
"type": "integer"
},
"female": {
"type": "integer"
},
"unknown": {
"type": "integer"
},
"from_llm": {
"type": "integer"
}
}
},
"data_version": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"object",
"null"
],
"description": "Set when `status` is `failed`. Branch on `code`.",
"properties": {
"code": {
"type": "string",
"enum": [
"source_missing",
"no_columns",
"name_column_missing",
"empty_file",
"bad_format",
"unreadable",
"no_credits",
"processing_error",
"stalled"
]
},
"message": {
"type": "string"
}
}
},
"result": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"csv",
"xlsx"
]
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
},
"inspection": {
"type": [
"object",
"null"
],
"description": "Only while `status` is `uploaded`.",
"properties": {
"columns": {
"type": "array",
"items": {
"type": "string"
}
},
"preview": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
},
"guessed_name_column": {
"type": [
"string",
"null"
]
},
"guessed_country_column": {
"type": [
"string",
"null"
]
},
"credits_needed": {
"type": "integer"
},
"credits_available": {
"type": "integer"
}
}
},
"poll_after_seconds": {
"type": [
"integer",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"started_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"finished_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/namegender-batch-job"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.