> ## Documentation Index > Fetch the complete documentation index at: https://docs.trysela.com/llms.txt > Use this file to discover all available pages before exploring further. # List Leads > Lists all leads. ## OpenAPI ````yaml /Sela_API.yaml get /api/leads/ openapi: 3.0.3 info: title: Sela API version: 1.0.2 description: Voice AI agents with superhuman conversion rates servers: - url: https://api.trysela.com/ description: Production API security: [] paths: /api/leads/: get: tags: - Leads summary: List Leads description: Lists all leads. operationId: leads_list parameters: - in: query name: external_id schema: type: string - in: query name: lead_type schema: type: integer - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedPartialLeadList' examples: ListOfLeads: value: count: 123 next: http://api.example.org/accounts/?page=4 previous: http://api.example.org/accounts/?page=2 results: - count: 1023 next: https://api.trysela.com/api/leads/?page=2 previous: null results: - id: 28013 email: first_name@trysela.com phone_number: '+18042221111' metadata: phone_number: '+18042221111' email: first_name@trysela.com first_name: First last_name: Name timezone: America/Los_Angeles created_at: 02/28/2025 15:09 property_address: 123 Main St property_city: San Francisco property_state: California property_zip: '94101' address: 456 2nd St city: Los Angeles state: California zip: '90001' lead_source: USDALoans.com external_id: id_in_your_crm_123 modified_time: '2025-02-28T15:09:03.139554-08:00' created_time: '2025-02-28T15:09:03.122515-08:00' status: OPEN status_reason: null lead_source: USDALoans.com lead_type: 123 representative: 456 next_call_time: 025-02-28T15:09:03.122515-08:00 next_call_time_reason: FIRST_CALL external_id: id_in_your_crm_123 us_state: CA received_time: '2025-02-28T15:09:03.122515-08:00' reengagements_count: 0 last_reengagement_time: null call_schedule_start_time: null sms_dnc: false call_dnc: false summary: List of leads description: Paginated list of leads. security: - tokenAuth: [] components: schemas: PaginatedPartialLeadList: type: object required: - count - results properties: count: type: integer example: 123 next: type: string nullable: true format: uri example: http://api.example.org/accounts/?page=4 previous: type: string nullable: true format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/PartialLead' PartialLead: type: object properties: id: type: integer readOnly: true email: type: string format: email nullable: true description: The email address of the lead. phone_number: type: string description: >- The phone number of the lead. Either E.164 or US format. Must have a valid area code. metadata: type: object additionalProperties: true nullable: true description: >- Any additional information associated with the lead as json metadata. Any of the values supplied here can be used by the agent in the talk track. Any additional payload fields that are not part of the standard lead fields will be automatically stored in the metadata upon lead creation or update, so lead metadata can also be sent as additional keys in the payload. Common fields to include in the metadata are `first_name` and `last_name`. modified_time: type: string format: date-time readOnly: true description: The last time this lead was modified. created_time: type: string format: date-time readOnly: true description: The time this lead was created. status: allOf: - $ref: '#/components/schemas/StatusEnum' description: |- The status of the lead. This is updated automatically. * `UNKNOWN` - Unknown * `NEW` - New * `OPEN` - Open * `CALLBACK_TO_TRANSFER` - Callback to transfer * `CLOSED` - Closed * `CLOSED_INCOMPLETE` - Closed incomplete * `LOST` - Lost * `SCHEDULE_COMPLETED` - Schedule completed * `OUT_OF_TERRITORY` - Out of territory * `BAD_NUMBER` - Bad number * `CANCELLED` - Cancelled status_detail: nullable: true description: >- Sub-type of the status outcome (e.g. blind_transfer, warm_transfer, appointment_booked). This is updated automatically. * `blind_transfer` - Blind transfer * `warm_transfer` - Warm transfer * `appointment_booked` - Appointment booked * `live_handoff_unavailable` - Live handoff unavailable * `escalation` - Escalation * `has_call_dnc` - Has call DNC * `tcpa_litigator` - TCPA litigator * `LEAD_ASSIGNED` - Lead assigned oneOf: - $ref: '#/components/schemas/StatusDetailEnum' - $ref: '#/components/schemas/BlankEnum' - $ref: '#/components/schemas/NullEnum' status_reason: nullable: true description: >- The reason for the current status of the lead. This is updated automatically. * `UNKNOWN` - Unknown * `WEBHOOK` - Webhook * `MANUAL` - Manual * `CHAT` - Chat * `REENGAGEMENT` - Reengagement oneOf: - $ref: '#/components/schemas/StatusReasonEnum' - $ref: '#/components/schemas/BlankEnum' - $ref: '#/components/schemas/NullEnum' lead_type: type: integer nullable: true description: The id of the campaign this lead is a part of. representative: type: integer nullable: true description: The id of the representative assigned to this lead. next_call_time: type: string nullable: true readOnly: true description: The time of the next call scheduled for this lead. next_call_time_reason: type: string nullable: true readOnly: true description: The reasons for the next call scheduled time for this lead. external_id: type: string nullable: true description: The external id of the lead. This can be your CRM id. maxLength: 255 us_state: nullable: true description: >- The US state of the lead. This is used to determine the timezone of the lead, as well as for compliance with telemarketing regulations. * `AL` - Alabama * `AK` - Alaska * `AS` - American Samoa * `AZ` - Arizona * `AR` - Arkansas * `AA` - Armed Forces Americas * `AE` - Armed Forces Europe * `AP` - Armed Forces Pacific * `CA` - California * `CO` - Colorado * `CT` - Connecticut * `DE` - Delaware * `DC` - District of Columbia * `FL` - Florida * `GA` - Georgia * `GU` - Guam * `HI` - Hawaii * `ID` - Idaho * `IL` - Illinois * `IN` - Indiana * `IA` - Iowa * `KS` - Kansas * `KY` - Kentucky * `LA` - Louisiana * `ME` - Maine * `MD` - Maryland * `MA` - Massachusetts * `MI` - Michigan * `MN` - Minnesota * `MS` - Mississippi * `MO` - Missouri * `MT` - Montana * `NE` - Nebraska * `NV` - Nevada * `NH` - New Hampshire * `NJ` - New Jersey * `NM` - New Mexico * `NY` - New York * `NC` - North Carolina * `ND` - North Dakota * `MP` - Northern Mariana Islands * `OH` - Ohio * `OK` - Oklahoma * `OR` - Oregon * `PA` - Pennsylvania * `PR` - Puerto Rico * `RI` - Rhode Island * `SC` - South Carolina * `SD` - South Dakota * `TN` - Tennessee * `TX` - Texas * `UT` - Utah * `VT` - Vermont * `VI` - Virgin Islands * `VA` - Virginia * `WA` - Washington * `WV` - West Virginia * `WI` - Wisconsin * `WY` - Wyoming oneOf: - $ref: '#/components/schemas/UsStateEnum' - $ref: '#/components/schemas/BlankEnum' - $ref: '#/components/schemas/NullEnum' lead_source: type: string nullable: true description: The source of the lead. This can be used to track the lead provider. maxLength: 255 received_time: type: string format: date-time readOnly: true nullable: true description: The time this lead was received by an API call. reengagements_count: type: integer description: The total number of times this lead has been reengaged. readOnly: true last_reengagement_time: type: string format: date-time readOnly: true nullable: true description: The time this lead was last reengaged. call_schedule_start_time: type: string format: date-time nullable: true sms_dnc: type: boolean description: >- If True, the lead has been marked as do not contact for the SMS channel (DNC). readOnly: true call_dnc: type: boolean description: >- If True, the lead has been marked as do not contact for the call channel (DNC). readOnly: true required: - call_dnc - created_time - id - last_reengagement_time - modified_time - next_call_time - next_call_time_reason - phone_number - received_time - reengagements_count - sms_dnc StatusEnum: enum: - UNKNOWN - NEW - OPEN - CALLBACK_TO_TRANSFER - CLOSED - CLOSED_INCOMPLETE - LOST - SCHEDULE_COMPLETED - OUT_OF_TERRITORY - BAD_NUMBER - CANCELLED type: string description: |- * `UNKNOWN` - Unknown * `NEW` - New * `OPEN` - Open * `CALLBACK_TO_TRANSFER` - Callback to transfer * `CLOSED` - Closed * `CLOSED_INCOMPLETE` - Closed incomplete * `LOST` - Lost * `SCHEDULE_COMPLETED` - Schedule completed * `OUT_OF_TERRITORY` - Out of territory * `BAD_NUMBER` - Bad number * `CANCELLED` - Cancelled StatusDetailEnum: enum: - blind_transfer - warm_transfer - appointment_booked - live_handoff_unavailable - escalation - has_call_dnc - tcpa_litigator - LEAD_ASSIGNED type: string description: |- * `blind_transfer` - Blind transfer * `warm_transfer` - Warm transfer * `appointment_booked` - Appointment booked * `live_handoff_unavailable` - Live handoff unavailable * `escalation` - Escalation * `has_call_dnc` - Has call DNC * `tcpa_litigator` - TCPA litigator * `LEAD_ASSIGNED` - Lead assigned BlankEnum: enum: - '' NullEnum: enum: - null StatusReasonEnum: enum: - UNKNOWN - WEBHOOK - MANUAL - CHAT - REENGAGEMENT type: string description: |- * `UNKNOWN` - Unknown * `WEBHOOK` - Webhook * `MANUAL` - Manual * `CHAT` - Chat * `REENGAGEMENT` - Reengagement UsStateEnum: enum: - AL - AK - AS - AZ - AR - AA - AE - AP - CA - CO - CT - DE - DC - FL - GA - GU - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - MP - OH - OK - OR - PA - PR - RI - SC - SD - TN - TX - UT - VT - VI - VA - WA - WV - WI - WY type: string description: |- * `AL` - Alabama * `AK` - Alaska * `AS` - American Samoa * `AZ` - Arizona * `AR` - Arkansas * `AA` - Armed Forces Americas * `AE` - Armed Forces Europe * `AP` - Armed Forces Pacific * `CA` - California * `CO` - Colorado * `CT` - Connecticut * `DE` - Delaware * `DC` - District of Columbia * `FL` - Florida * `GA` - Georgia * `GU` - Guam * `HI` - Hawaii * `ID` - Idaho * `IL` - Illinois * `IN` - Indiana * `IA` - Iowa * `KS` - Kansas * `KY` - Kentucky * `LA` - Louisiana * `ME` - Maine * `MD` - Maryland * `MA` - Massachusetts * `MI` - Michigan * `MN` - Minnesota * `MS` - Mississippi * `MO` - Missouri * `MT` - Montana * `NE` - Nebraska * `NV` - Nevada * `NH` - New Hampshire * `NJ` - New Jersey * `NM` - New Mexico * `NY` - New York * `NC` - North Carolina * `ND` - North Dakota * `MP` - Northern Mariana Islands * `OH` - Ohio * `OK` - Oklahoma * `OR` - Oregon * `PA` - Pennsylvania * `PR` - Puerto Rico * `RI` - Rhode Island * `SC` - South Carolina * `SD` - South Dakota * `TN` - Tennessee * `TX` - Texas * `UT` - Utah * `VT` - Vermont * `VI` - Virgin Islands * `VA` - Virginia * `WA` - Washington * `WV` - West Virginia * `WI` - Wisconsin * `WY` - Wyoming securitySchemes: tokenAuth: type: apiKey in: header name: Authorization description: Token-based authentication with required prefix "Token" ````