> ## Documentation Index
> Fetch the complete documentation index at: https://docs.journeybee.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Individual Lead

> Retrieve detailed information about a specific lead including custom fields, notes, and relationships

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.journeybee.io/api/v1/companies/{companyId}/leads/{leadId}" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.journeybee.io/api/v1/companies/{companyId}/leads/{leadId}', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer your-api-key-uuid',
      'Content-Type': 'application/json'
    }
  });
  ```
</CodeGroup>

## Path Parameters

<ParamField path="companyId" type="number" required>
  The unique identifier of the company
</ParamField>

<ParamField path="leadId" type="number" required>
  The unique identifier of the lead
</ParamField>

## Response Schema

<ResponseField name="lead" type="object">
  Detailed lead object

  <Expandable title="Lead Details">
    <ResponseField name="id" type="number">Lead ID</ResponseField>
    <ResponseField name="uuid" type="string">Lead UUID</ResponseField>
    <ResponseField name="created_at" type="string">Creation timestamp</ResponseField>
    <ResponseField name="updated_at" type="string">Last update timestamp</ResponseField>
    <ResponseField name="source" type="string">Lead source</ResponseField>
    <ResponseField name="company_name" type="string">Lead company name</ResponseField>
    <ResponseField name="email" type="string">Lead contact email</ResponseField>
    <ResponseField name="phone_number" type="string">Lead contact phone</ResponseField>
    <ResponseField name="first_name" type="string">Lead contact first name</ResponseField>
    <ResponseField name="last_name" type="string">Lead contact last name</ResponseField>
    <ResponseField name="status" type="string">Lead status</ResponseField>
    <ResponseField name="partner_type" type="string">Partner relationship type</ResponseField>
    <ResponseField name="company_id" type="number">Owner company ID</ResponseField>
    <ResponseField name="created_by_user_id" type="number">Creator user ID</ResponseField>

    <ResponseField name="custom_fields" type="array">
      Array of custom field values

      <Expandable title="Custom Field Value">
        <ResponseField name="id" type="number">Custom field ID</ResponseField>
        <ResponseField name="label" type="string">Field label</ResponseField>
        <ResponseField name="type" type="string">Field type</ResponseField>
        <ResponseField name="value" type="object">Field value</ResponseField>
        <ResponseField name="custom_field_value_id" type="number">Value record ID</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="tags" type="array">Array of assigned tags</ResponseField>
    <ResponseField name="assigned_users" type="array">Array of assigned users</ResponseField>
    <ResponseField name="partnership_leads" type="array">Partnership relationship data</ResponseField>
    <ResponseField name="lead_deals" type="array">Associated deals</ResponseField>
  </Expandable>
</ResponseField>

## Example Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": 789,
    "uuid": "lead-uuid-789",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T12:45:00Z",
    "source": "partnership",
    "company_name": "TechCorp Solutions",
    "email": "contact@techcorp.com",
    "phone_number": "+1-555-123-4567",
    "first_name": "John",
    "last_name": "Smith",
    "status": "new",
    "partner_type": "referral",
    "company_id": 123,
    "created_by_user_id": 456,
    "custom_fields": [
      {
        "id": 5,
        "label": "Revenue Potential",
        "type": "number",
        "value": {
          "number": 100000
        },
        "custom_field_value_id": 123
      }
    ],
    "tags": [
      {
        "id": 10,
        "label": "High Priority",
        "background_color": "#EF4444",
        "text_color": "#FFFFFF"
      }
    ],
    "assigned_users": [
      {
        "id": 456,
        "email": "jane@company.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "color": "#3B82F6"
      }
    ],
    "partnership_leads": [
      {
        "id": 123,
        "partnership_id": 456,
        "sent_by_company_name": "Partner Corp",
        "direction": "received"
      }
    ],
    "lead_deals": [
      {
        "id": 345,
        "label": "TechCorp Deal",
        "deal_value": 50000,
        "stage_label": "Proposal"
      }
    ]
  }
  ```
</ResponseExample>

## Notes

* Requires API key with `read_access` permission
* Returns comprehensive lead details including relationships
* Used for lead detail views and form population