Skip to main content
GET
/
v1
/
leads
/
{id}
Get lead
curl --request GET \
  --url https://api.example.com/v1/leads/{id}
{
  "data": {
    "id": 44,
    "status": "submitted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": null,
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      },
      {
        "question": "Company",
        "answer": "Acme Inc"
      },
      {
        "question": "Budget",
        "answer": "$10,000+"
      }
    ],
    "can_be_converted": true,
    "can_be_rejected": true
  },
  "status": 1
}

​
Endpoint

GET https://api.partnero.com/v1/leads/{id}

​
Path Parameters

ParameterTypeRequiredDescription
idintegerYesLead’s unique ID

​
Request

cURL
curl --location 'https://api.partnero.com/v1/leads/44' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Response

{
  "data": {
    "id": 44,
    "status": "submitted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": null,
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      },
      {
        "question": "Company",
        "answer": "Acme Inc"
      },
      {
        "question": "Budget",
        "answer": "$10,000+"
      }
    ],
    "can_be_converted": true,
    "can_be_rejected": true
  },
  "status": 1
}

​
Response Fields

FieldTypeDescription
data.idintegerUnique lead ID
data.statusstringLead status: submitted, converted, rejected
data.lead_infoobjectBasic lead information
data.lead_info.namestringLead’s name
data.lead_info.emailstringLead’s email
data.submitterobjectPartner who submitted the lead
data.submitter.idstringPartner ID
data.submitter.namestringPartner name
data.submitter.emailstringPartner email
data.submission_formarrayCustom form field responses
data.converted_toobject | nullCustomer data if converted
data.can_be_convertedbooleanWhether lead can be converted to customer
data.can_be_rejectedbooleanWhether lead can be rejected