# Export directors `GET /api/v1/directors/export` Downloads matching directors as a CSV file. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Directors → Read**. ## Query parameters - `status` (string) — Use archived to export archived directors. The default is to export active directors. - `archived_at` (integer) — Legacy filter. Use 1 to export archived directors. - `team_id` (integer) — Include directors assigned to this team. - `exclude_team_id` (integer) — Exclude directors assigned to this team. - `include_birth` (integer) — Use 1 to include birth and nationality columns. - `include_residence` (integer) — Use 1 to include residence and contact columns. - `include_contacts` (integer) — Use 1 to include email and phone. - `include_qualification` (integer) — Use 1 to include qualification columns. - `include_metadata` (integer) — Use 1 to include custom metadata columns. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --get \ --url "https://api.asdincloud.com/api/v1/directors/export" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --data-urlencode "include_contacts=1" \ --output "directors.csv" ``` ## Response **200 OK** Returns a CSV attachment with all matching rows. ```http HTTP/1.1 200 OK Content-Type: text/csv; charset=UTF-8 Content-Disposition: attachment; filename="export_directors_2026-11-14_120000.csv" ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found.