# Poll DNB Lookup Job

After you have started a curation job, you will receive a job id in the response: 
Use this ID to poll for the status of the job using this endpoint. Once the status is FINISHED, you can download the results.


Endpoint: GET /dnb/lookupjobs/{id}
Version: 3
Security: apiKey

## Path parameters:

  - `id` (string, required)
    ID of the DNB lookup job.
    Example: "cbed7ac6-a97d-4c23-9060-2a88fa660957"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier of a job.
    Example: "35f23c03-1c22-45fe-9484-3ffe769325de"

  - `storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `status` (string)
    Job execution status.
    Enum: "UNKNOWN", "CANCELED", "CREATED", "PERSISTED", "SCHEDULED", "WAITING", "COULDNT_START", "RUNNING", "FINISHED", "DIED", "FAILED"

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-09-12T14:57:59Z"

  - `createdBy` (string)
    Creator of a resource.
    Example: "76248934691294444"

  - `progress` (integer)
    Progress (%) of the job.
    Example: "77"

  - `result` (object)
    Lookup Job result for D&B data.

  - `result.statistics` (object)
    Contains statistics about a DNB lookup job like number of records, number of failed records, etc.

  - `result.statistics.numberOfRecords` (integer)
    Number of records in the input storage.
    Example: "10"

  - `result.statistics.numberOfFailed` (integer)
    Number of records updates / retrieves fails.
    Example: "0"

  - `result.statistics.numberOfInserts` (integer)
    Number of successfully retrieved data.
    Example: "10"

  - `result.statistics.numberOfQuotaExceeded` (integer)
    Number of not processed records which exceeded defined quota limit.
    Example: "10"

  - `result.statistics.numberOfUnknown` (integer)
    Number of non-retrieved records from DNB service.
    Example: "0"

  - `modifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-09-12T14:57:59Z"

  - `statusMessage` (string)
    Additional information to explain the status.
    Example: "The job failed because storage is empty."