> ## Documentation Index > Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # List tags > Lists tags for contacts or companies ## OpenAPI ````yaml /developers/openapi.yaml get /v1/tags openapi: 3.0.3 info: title: TalkToHumans Public API version: 1.0.0 license: name: Proprietary description: > Read and organize the LinkedIn organization data your team already manages in TalkToHumans: accounts, contacts, tags, notes, custom fields, sequence state, conversations, templates, and views. servers: - url: https://api.talktohumans.app description: TalkToHumans API security: - bearerAuth: [] tags: - name: Organization description: Organization details for the current API key. - name: LinkedIn description: LinkedIn accounts, contacts, companies, and conversations. - name: Activity description: Activity for organization reporting. - name: Enrich description: Profile enrichment for LinkedIn contacts and companies. - name: Views description: Saved TalkToHumans views. - name: Sequences description: Sequences of contacts and conversations. - name: Templates description: Message and sequence templates. - name: Custom fields description: Custom fields for contacts and companies. - name: Tags description: Tags for contacts and companies. paths: /v1/tags: get: tags: - Tags summary: List tags description: Lists tags for contacts or companies operationId: listTags parameters: - name: object_type in: query description: Object the tags belong to. Defaults to contact. schema: type: string enum: - contact - company default: contact responses: '200': description: Tags. content: application/json: schema: $ref: '#/components/schemas/ListTagsEnvelope' example: data: tags: - id: 3c9e1f2a7b4d4e8f9a0b1c2d3e4f5a6b name: Hot lead color: red object_type: contact - id: 7d2a4b6c8e0f4a1b3c5d7e9f0a2b4c6d name: Investor color: purple object_type: contact '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalServerError' components: schemas: ListTagsEnvelope: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/ListTagsResponse' ListTagsResponse: type: object additionalProperties: false required: - tags properties: tags: type: array items: $ref: '#/components/schemas/TagDefinition' Error: type: object additionalProperties: false required: - code - message properties: code: type: string description: Machine-readable error code. enum: - unauthorized - forbidden - not_found - bad_request - internal_error - conflict - rate_limit_exceeded - account_shared_access_required - linkedin_not_connected - billing_payment_failed - billing_subscription_incomplete - billing_subscription_expired - billing_grace_period - billing_feature_not_available - billing_insufficient_credits - billing_invalid - enrichment_failed - enrichment_in_progress - linkedin_profile_not_found message: type: string description: Human-readable error message. debug: type: string description: Development-only debug details. TagDefinition: type: object additionalProperties: false required: - id - name - color - object_type properties: id: type: string description: >- Tag ID for updating or deleting the tag. Contact and company updates use the name. name: type: string color: $ref: '#/components/schemas/TagColor' object_type: type: string enum: - contact - company TagColor: type: string enum: - green - orange - blue - red - purple - yellow - pink - grey responses: BadRequest: description: Invalid request. `message` explains what to fix. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: >- field "account_id" must be a string, got number; IDs are strings, e.g. "42" Unauthorized: description: Missing, malformed, invalid, or retired local API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingAuthorization: value: code: unauthorized message: Authorization header is required invalidAuthorizationFormat: value: code: unauthorized message: Authorization header must use Bearer scheme invalidAPIKey: value: code: unauthorized message: Invalid API key Forbidden: description: >- API access is not enabled for the organization, or the API key cannot resolve to an active organization user. content: application/json: schema: $ref: '#/components/schemas/Error' examples: forbidden: value: code: forbidden message: you don't have access to this organization featureUnavailable: value: code: billing_feature_not_available message: >- Feature 'TalkToHumansAPI' is not available in your current plan insufficientCredits: value: code: billing_insufficient_credits message: Insufficient credits apiKeyPrincipalInvalid: value: code: forbidden message: >- This API key is no longer linked to an active organization user. Ask an organization admin to regenerate it RateLimited: description: >- Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint. headers: Retry-After: description: Seconds to wait before retrying the request. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limit_exceeded message: Rate limit exceeded InternalServerError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: internal_error message: An internal error occurred securitySchemes: bearerAuth: type: http scheme: bearer description: 'Pass API key as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.