# Get prospect enrichment

> **Documentation index**
> Browse the [Woodpecker developer documentation index](https://developers.woodpecker.co/llms.txt) to discover related API references, guides, webhooks, MCP tools, and CLI documentation.

> Retrieve status details for a prospect enrichment batch. Use this endpoint after [queueing prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/queue-prospect-enrichments.md) when you already know the batch ID and want the most direct lookup.

Retrieve status details for a prospect enrichment batch. Use this endpoint after [queueing prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/queue-prospect-enrichments.md) when you already know the batch ID and want the most direct lookup.

Use this endpoint to retrieve prospect enrichment statuses for a single batch. To retrieve statuses across multiple batches, use [list prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/list-prospect-enrichments.md).

## Request

### Endpoint

```text
GET https://api.woodpecker.co/rest/v2/lead_finder/prospects/enrichments/{uuid}
```

### Headers

```text
x-api-key: {YOUR_API_KEY}
```

For details on how to authenticate your requests, please see the [authentication guide](https://developers.woodpecker.co/docs/getting-started/authentication.md).

### Parameters

| Parameter | Required | Type | Description |
|-----------|:--------:|------|-------------|
| `uuid` | Yes | string | Enrichment batch UUID returned by [queue prospect enrichments](https://developers.woodpecker.co/docs/lead-finder/prospect-enrichment/queue-prospect-enrichments.md) |

### Request samples

#### Retrieve one prospect enrichment batch

  
  ```bash
  curl --request GET \
    --url "https://api.woodpecker.co/rest/v2/lead_finder/prospects/enrichments/{uuid}" \
    --header "x-api-key: {YOUR_API_KEY}"
  ```
  
  
  ```python
  import requests

  def get_prospect_enrichment():
    url = "https://api.woodpecker.co/rest/v2/lead_finder/prospects/enrichments/{uuid}"
    headers = {
      "x-api-key": "{YOUR_API_KEY}"
    }

    response = requests.get(url, headers=headers)

    if response.status_code == 200:
      print("GET response:", response.json())
    else:
      print("GET failed with status:", response.status_code, response.text)

  if __name__ == "__main__":
    get_prospect_enrichment()
  ```
  
  
  ```java
  import java.net.URI;
  import java.net.http.HttpClient;
  import java.net.http.HttpRequest;
  import java.net.http.HttpResponse;

  public class WoodpeckerApiClient {
    private static final String API_KEY = "{YOUR_API_KEY}";

    public static void main(String[] args) {
      getProspectEnrichment();
    }

    public static void getProspectEnrichment() {
      try {
        String url = "https://api.woodpecker.co/rest/v2/lead_finder/prospects/enrichments/{uuid}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
          .uri(new URI(url))
          .header("x-api-key", API_KEY)
          .GET()
          .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() == 200) {
          System.out.println("GET response: " + response.body());
        } else {
          System.err.println("GET request failed: " + response.statusCode());
        }
      } catch (Exception e) {
        e.printStackTrace();
      }
    }
  }
  ```
  
  
  ```js
  const axios = require("axios");

  async function getProspectEnrichment() {
    const url = "https://api.woodpecker.co/rest/v2/lead_finder/prospects/enrichments/{uuid}";
    const headers = {
      "x-api-key": "{YOUR_API_KEY}"
    };

    try {
      const response = await axios.get(url, { headers });

      if (response.status === 200) {
        console.log("GET response:", response.data);
      } else {
        console.error("GET request failed:", response.status);
      }
    } catch (error) {
      console.error("Request error:", error.response?.status || error.message);
    }
  }

  getProspectEnrichment();
  ```
  
  
  ```php
  <?php
  require 'vendor/autoload.php';

  use GuzzleHttp\Client;
  use GuzzleHttp\Exception\RequestException;

  $client = new Client([
    'base_uri' => 'https://api.woodpecker.co/rest/v2/',
    'headers'  => [
      'x-api-key' => getenv('WOODPECKER_API_KEY'),
    ],
  ]);

  try {
    $response = $client->get('lead_finder/prospects/enrichments/{uuid}');

    echo $response->getStatusCode(), "\n";
    echo $response->getBody(), "\n";
  } catch (RequestException $e) {
    echo "Error: ", $e->getMessage(), "\n";
    if ($e->hasResponse()) {
      echo $e->getResponse()->getBody(), "\n";
    }
  }
  ```
  

## Response

### Response examples

  

  Prospect enrichment fetched successfully.

  ```json
  {
    "prospect_enrichments": [
      {
        "uuid": "e9e6abc4-729e-4c22-b412-8917b1db919d",
        "prospect_email": "erlich@bachmanity.com",
        "created": "2026-05-01T10:00:00+02:00",
        "status": "PROCESSED_ENRICHED"
      }
    ]
  }
  ```

  #### Body schema

  | Field | Type | Description |
  |-------|------|-------------|
  | `prospect_enrichments` | array[object] | Prospect enrichment status records for the requested batch |
  | &nbsp;&nbsp;└─ `uuid` | string | Enrichment batch identifier |
  | &nbsp;&nbsp;└─ `prospect_email` | string | Prospect email address |
  | &nbsp;&nbsp;└─ `created` | string | Record creation timestamp in ISO 8601 format |
  | &nbsp;&nbsp;└─ `status` | string | Processing status: `PENDING`, `PROCESSED_ENRICHED`, or `PROCESSED_NOT_ENRICHED` |
  
  

  The batch UUID was not found for the authenticated account. A `404` can mean the enrichment batch is unavailable to this account, or that the request URL points to the wrong resource.

  ```json
  {
    "title": "Not Found",
    "status": 404,
    "details": "Prospect enrichment with uuid 65d58771-7da2-44ff-b891-5e8484393635 was not found",
    "timestamp": "2026-05-01 10:00:00",
    "extra": null
  }
  ```

  #### Body schema

  | Field | Type | Description |
  |-------|------|-------------|
  | `title` | string | A short title describing the error |
  | `status` | integer | The HTTP status code |
  | `details` | string | A detailed message explaining which resource was not found |
  | `timestamp` | string | The timestamp when the error occurred, `YYYY-MM-DD HH:MM:SS` UTC |
  | `extra` | string/null | Additional information about the error, when available |

  
  

  An issue with authorization. Please review the [authentication guide](https://developers.woodpecker.co/docs/getting-started/authentication.md).

  ```json
  {
    "title": "Unauthorized",
    "status": 401,
    "detail": "Invalid api key",
    "timestamp": "2026-05-01 10:00:00"
  }
  ```

  #### Body schema

  | Field | Type | Description |
  |-------|------|-------------|
  | `title` | string | A short title describing the error |
  | `status` | integer | The HTTP status code |
  | `detail` | string | A detailed message explaining the authorization problem |
  | `timestamp` | string | The timestamp when the error occurred, `YYYY-MM-DD HH:MM:SS` UTC |

  
  

  Unexpected error, please try again later.

  ```json
  {
    "title": "Internal server error",
    "status": 500,
    "details": "An unexpected error has occurred. Please try again later.",
    "timestamp": "2025-03-05 17:57:00"
  }
  ```

  #### Body schema

  | Field | Type | Description |
  |-------|------|-------------|
  | `title` | string | A short title describing the error |
  | `status` | integer | The HTTP status code |
  | `details` | string | A detailed message explaining the error |
  | `timestamp` | string | The timestamp when the error occurred, `YYYY-MM-DD HH:MM:SS` UTC |