> ## Documentation Index > Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt > Use this file to discover all available pages before exploring further. # PublicApiListContacts > GET /api/v1/organizations/{orgId}/workspaces/{wsId}/contacts Use this endpoint through the Developer API or the matching `firstsales` CLI command when available. Responses use the stable FirstSales public error envelope. ## OpenAPI ````yaml GET /api/v1/organizations/{orgId}/workspaces/{wsId}/contacts openapi: 3.1.0 info: title: FirstSales Developer API version: 1.0.0 description: >- Public v1 developer API for FirstSales.io. Generated from live step definitions — do not hand-edit. servers: - url: https://sandbox.api.app.firstsales.io - url: https://api.app.firstsales.io security: - bearerAuth: [] tags: - name: Activities - name: Alerts - name: API Keys - name: Authentication - name: Billing - name: Blocked Domains - name: Campaigns - name: Companies - name: Connectors - name: Contacts - name: Copilot - name: Dashboard - name: Deals - name: Direct Email - name: Email Authentication - name: Inbox - name: Knowledge Bases - name: Learning - name: Offerings - name: Organizations - name: Product Updates - name: Sequence Library - name: Signals description: >- Beta. Find people who comment on or react to LinkedIn posts by a keyword, a person or a company page. Each scan costs 10x the scraper cost in credits (1 credit = $0.01), capped by the daily budget of the signal. A scan that adds no new person is free. - name: Suppression - name: Team - name: Tracking Domains - name: Warmup paths: /api/v1/organizations/{orgId}/workspaces/{wsId}/contacts: get: tags: - Contacts summary: PublicApiListContacts operationId: listContacts parameters: - name: orgId in: path required: true schema: type: string - name: wsId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer minimum: 1 default: 1 - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 10 - name: sortBy in: query required: false schema: type: string enum: - createdAt - email - firstName - company default: createdAt - name: sortOrder in: query required: false schema: type: string enum: - asc - desc default: desc - name: search in: query required: false schema: type: string maxLength: 100 - name: status in: query required: false schema: type: string enum: - active - bounced - unsubscribed - name: source in: query required: false schema: type: string enum: - csv-import - ai-leads - webhook - signal - manual - name: tags in: query required: false schema: type: string maxLength: 500 - name: company in: query required: false schema: type: string maxLength: 200 - name: listId in: query required: false schema: type: string pattern: ^[0-9a-fA-F]{24}$ - name: verificationStatus in: query required: false schema: type: string enum: - clean - risky - dirty - unknown - name: mobileOnly in: query required: false schema: type: boolean responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/PublicContactListResponse' '400': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '401': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '403': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '404': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '429': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '500': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '503': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' security: - developerKeyBearer: [] components: schemas: PublicContactListResponse: type: object properties: contacts: type: array items: type: object properties: id: type: string pattern: ^[0-9a-fA-F]{24}$ workspaceId: type: string minLength: 1 email: type: string firstName: type: - string - 'null' lastName: type: - string - 'null' fullName: type: - string - 'null' headline: type: - string - 'null' linkedinUrl: type: - string - 'null' company: anyOf: - type: string - type: object properties: name: type: string maxLength: 200 website: type: string maxLength: 500 domain: type: string maxLength: 253 linkedinUrl: type: string maxLength: 500 industry: type: string maxLength: 200 size: type: integer minimum: 0 additionalProperties: false - type: 'null' title: type: - string - 'null' phone: type: - string - 'null' location: anyOf: - type: object properties: city: type: string maxLength: 100 state: type: string maxLength: 100 country: type: string maxLength: 100 additionalProperties: false - type: 'null' tags: type: array items: type: string lists: type: array items: type: string minLength: 1 customFields: type: object additionalProperties: true source: type: string enum: - csv-import - ai-leads - webhook - signal - manual status: type: string enum: - active - bounced - unsubscribed oooStatus: type: string oooUntil: type: - string - 'null' format: date-time timezone: type: - string - 'null' verificationStatus: type: string enum: - clean - risky - dirty - unknown createdAt: type: - string - 'null' format: date-time updatedAt: type: - string - 'null' format: date-time required: - id - workspaceId - email - firstName - lastName - fullName - headline - linkedinUrl - company - title - phone - location - tags - lists - customFields - source - status - oooStatus - oooUntil - timezone - verificationStatus - createdAt - updatedAt additionalProperties: false pagination: $ref: '#/components/schemas/Pagination' required: - contacts - pagination additionalProperties: false PublicErrorEnvelope: type: object properties: error: type: object properties: code: type: string message: type: string requestId: type: string details: type: object additionalProperties: true required: - code - message - requestId required: - error Pagination: type: object properties: page: type: integer limit: type: integer total: type: integer totalPages: type: integer required: - page - limit - total - totalPages securitySchemes: bearerAuth: type: http scheme: bearer description: Legacy compatibility bearer scheme for generated consumers. developerKeyBearer: type: http scheme: bearer description: FirstSales developer API key bearer token (fs-key-*). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.