# Skipcall Public Documentation

## Docs

- [Authentication](https://docs.skipcall.app/api-reference/api-documentation/authentication.md): Learn how to authenticate your API requests using API keys
- [Rate limits](https://docs.skipcall.app/api-reference/api-documentation/rate-limiting.md): Understand API rate limits and how to handle them
- [Get current API key info](https://docs.skipcall.app/api-reference/authentication/get-current-api-key-info.md): Returns information about the authenticated API key and organization
- [Get a call](https://docs.skipcall.app/api-reference/calls/get-a-call.md): Returns a single call by ID
- [Get call recording](https://docs.skipcall.app/api-reference/calls/get-call-recording.md): Returns the recording metadata for a call
- [Get call transcription](https://docs.skipcall.app/api-reference/calls/get-call-transcription.md): Returns the transcription for a call
- [List calls](https://docs.skipcall.app/api-reference/calls/list-calls.md): Returns a paginated list of calls for your organization
- [Create a contact](https://docs.skipcall.app/api-reference/contacts/create-a-contact.md): Creates a new contact in your organization
- [Delete a contact](https://docs.skipcall.app/api-reference/contacts/delete-a-contact.md): Soft-deletes a contact. The contact can no longer be retrieved after deletion.
- [Get a contact](https://docs.skipcall.app/api-reference/contacts/get-a-contact.md): Returns a single contact by ID
- [List contacts](https://docs.skipcall.app/api-reference/contacts/list-contacts.md): Returns a paginated list of contacts for your organization
- [Update a contact](https://docs.skipcall.app/api-reference/contacts/update-a-contact.md): Updates an existing contact. Only provided fields will be updated.
- [Create a custom field](https://docs.skipcall.app/api-reference/custom-fields/create-a-custom-field.md): Creates a new custom field in your organization. A stable `slug` is automatically generated from the `name` and returned in the response. The slug is immutable: renaming the custom field later will not change it.
- [Delete a custom field](https://docs.skipcall.app/api-reference/custom-fields/delete-a-custom-field.md): Permanently deletes a custom field and all its associated values across contacts
- [Get a custom field](https://docs.skipcall.app/api-reference/custom-fields/get-a-custom-field.md): Returns a single custom field by ID
- [List custom fields](https://docs.skipcall.app/api-reference/custom-fields/list-custom-fields.md): Returns a paginated list of custom fields for your organization. Each custom field has a stable `slug` (immutable) and a human-readable `name` (editable). Use the `slug` as the key when setting custom field values on contacts.
- [Update a custom field](https://docs.skipcall.app/api-reference/custom-fields/update-a-custom-field.md): Updates an existing custom field name. The `slug` is **not** modified by this operation — it remains stable for integrations.
- [Health check endpoint](https://docs.skipcall.app/api-reference/health/health-check-endpoint.md)
- [Introduction](https://docs.skipcall.app/api-reference/introduction.md): Get started with the Skipcall API to programmatically manage your data
- [Create a sequence](https://docs.skipcall.app/api-reference/sequences/create-a-sequence.md): Creates a new sequence. Use the /users endpoint to get organizationMembershipIds for assignedToIds and creatorId.
- [Get a sequence by ID](https://docs.skipcall.app/api-reference/sequences/get-a-sequence-by-id.md): Returns the details of a specific sequence.
- [List contacts of a sequence](https://docs.skipcall.app/api-reference/sequences/list-contacts-of-a-sequence.md): Returns a paginated list of contacts in a sequence, enriched with their tags and call history within the sequence. Supports filtering by tag label and contact status.
- [List sequences](https://docs.skipcall.app/api-reference/sequences/list-sequences.md): Returns a paginated list of sequences for your organization.
- [Get call duration statistics](https://docs.skipcall.app/api-reference/statistics/get-call-duration-statistics.md): Returns call count, average duration, and total duration. Can be filtered by sequence, user, date range, and team.
- [Get call status distribution](https://docs.skipcall.app/api-reference/statistics/get-call-status-distribution.md): Returns the distribution of calls by status, plus count of contacts not yet called.
- [Get tag distribution](https://docs.skipcall.app/api-reference/statistics/get-tag-distribution.md): Returns the distribution of contacts by tags applied after calls.
- [Create a tag](https://docs.skipcall.app/api-reference/tags/create-a-tag.md): Creates a new tag for use in sequences to qualify call results.
- [Delete a tag](https://docs.skipcall.app/api-reference/tags/delete-a-tag.md): Deletes a tag. Cannot delete the last success tag — at least one must remain per team.
- [Get a tag by ID](https://docs.skipcall.app/api-reference/tags/get-a-tag-by-id.md): Returns the details of a specific tag.
- [List tags](https://docs.skipcall.app/api-reference/tags/list-tags.md): Returns a paginated list of tags for your organization.
- [Update a tag](https://docs.skipcall.app/api-reference/tags/update-a-tag.md): Updates an existing tag. Only provided fields will be updated.
- [Get stats aggregated by team](https://docs.skipcall.app/api-reference/teams/get-stats-aggregated-by-team.md): Returns call, contact, and sequence stats per team. Scope is limited to the API key's accessible teams.
- [List teams accessible by this API key](https://docs.skipcall.app/api-reference/teams/list-teams-accessible-by-this-api-key.md): Returns all teams within the scope of the API key.
- [List organization users](https://docs.skipcall.app/api-reference/users/list-organization-users.md): Returns a paginated list of users (organization members) for your organization. Use the organizationMembershipId to create sequences.

## OpenAPI Specs

- [docs-json](https://api-public.skipcall.app/docs-json)
- [openapi](https://docs.skipcall.app/api-reference/openapi.json)

## Optional

- [Site internet](https://skipcall.io)