---
updatedAt: 2026-06-26T12:18:21.000Z
agentTools:
  projectIndex: https://developers.dexatel.com/llms.txt
---

# Create Bulk Lookup resource

Perform a bulk lookup. Maximum bulk lookup size: **100,000 phone numbers**.

<br />

<TitleSetter title="Create Bulk HLR Lookup | Dexatel API" />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Miscellaneous",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://api.dexatel.com",
      "description": "Server base url"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "paths": {
    "/v1/bulk-lookups": {
      "post": {
        "tags": [
          "Bulk HLR Lookup"
        ],
        "summary": "Create Bulk Lookup resource",
        "description": "Perform a bulk lookup. Maximum bulk lookup size: **100,000 phone numbers**.",
        "operationId": "bulk-hlr-lookups-create",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "contentType": "text/csv"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "*": {
                "schema": {
                  "$ref": "#/components/schemas/BulkHLRLookupsResponseWrapperDto"
                }
              }
            }
          },
          "400": {
            "description": "<p> <strong>Bad Request:</strong> </p> <table> <tr> <th>Code</th> <th>Message</th> <th>Description</th> </tr> <tr> <td>7911</td> <td>Invalid file type, only .csv files are allowed</td> <td>File should be in .csv format</td> </tr> <tr> <td>7912</td> <td>The CSV file contains wrong data</td> <td>CSV file must contain \"number\" header</td> </tr><tr> <td>7926</td> <td>Not implemented yet</td> <td>MNP lookup is not supported</td> </tr> </table>"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BulkHLRLookupsResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier of the resource"
          },
          "file_name": {
            "type": "string",
            "description": "Uploaded file name"
          },
          "account_id": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier of the account"
          },
          "status": {
            "type": "string",
            "enum": [
              "IN_PROGRESS",
              "FAILED",
              "COMPLETED",
              "NOT_ENOUGH_BALANCE"
            ],
            "description": "Indicates the progress of bulk lookup."
          },
          "total": {
            "type": "number",
            "description": "Shows total count of numbers in the file"
          },
          "checked": {
            "type": "number",
            "description": "Shows count of checked numbers in the file"
          },
          "skipped": {
            "type": "number",
            "description": "Shows count of skipped numbers in the file"
          },
          "create_date": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the bulk lookup in UTC, formatted as yyyy-mm-dd hh:mm:ss"
          }
        }
      },
      "BulkHLRLookupsResponseWrapperDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/BulkHLRLookupsResponseDto"
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Dexatel-Key"
      }
    }
  }
}
```