{
"message": "The to field must be a date after or equal to from.",
"errors": {
"to": [
"The to field must be a date after or equal to from."
]
}
}
{
"message": "Too Many Attempts."
}
Services
List your services
Lists your services of one type, paginated. Without type you get your
default services: the ones visitors can book right now, which means
active and within your plan’s service limit, with the is_default one
first. Single-use services are listed newest first, whatever their
status.
{
"message": "The to field must be a date after or equal to from.",
"errors": {
"to": [
"The to field must be a date after or equal to from."
]
}
}
{
"message": "Too Many Attempts."
}
Every service has a type:
type
What it is
default
A permanent booking page, such as “Intro call”.
single_use
A private booking link for one person, spent once it’s booked. Bookings through it are accepted and never paid.
Don’t confuse type: "default" with is_default. is_default marks the one
service your booking page highlights.
Authorizations
Authorization
string
header
required
An API key from Settings → API Keys (starts with tikk_sk_), or an
OAuth access token for a partner app. Both carry scopes; each endpoint
lists the one it needs.
Scopes
services.read
Query Parameters
type
enum<string>
default:default
Which type of service to list.
Available options:
default,
single_use
per_page
integer
default:25
Results per page.
Required range: 1 <= x <= 100
page
integer
default:1
Page to return.
Required range: x >= 1
Response
A page of services.
data
(Default service · object | Single-use service · object)[]
required
Services of the requested type.
A permanent booking page, such as "Intro call".
Default service
Single-use service
Show child attributes
links
object
required
Show child attributes
meta
object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tikk","colors":{"primary":"#848484","light":"#151515","dark":"#cbcbcb"},"logo":{"light":"https://mintcdn.com/tikk/V1Cxv-mnTLJxEuos/images/logo.svg?fit=max\u0026auto=format\u0026n=V1Cxv-mnTLJxEuos\u0026q=85\u0026s=3c872a88f73e2a482351b0af4a8f9664","dark":"https://mintcdn.com/tikk/V1Cxv-mnTLJxEuos/images/logo-white.svg?fit=max\u0026auto=format\u0026n=V1Cxv-mnTLJxEuos\u0026q=85\u0026s=0bb9108d1260f6cdbbe3adb03c6bdd42"},"favicon":{"light":"https://mintcdn.com/tikk/V1Cxv-mnTLJxEuos/images/logo-icon2.svg?fit=max\u0026auto=format\u0026n=V1Cxv-mnTLJxEuos\u0026q=85\u0026s=969244754da700eeec1d0ffe5983dedc","dark":"https://mintcdn.com/tikk/V1Cxv-mnTLJxEuos/images/logo-icon2.svg?fit=max\u0026auto=format\u0026n=V1Cxv-mnTLJxEuos\u0026q=85\u0026s=969244754da700eeec1d0ffe5983dedc"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python","php"]}},"appearance":{"default":"light","strict":true},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://developer.tikk.chat","label":"Developer portal"}],"primary":{"type":"button","label":"Get Started Free","href":"https://app.tikk.chat/register"}},"footer":{"socials":{"website":"https://tikk.chat","linkedin":"https://www.linkedin.com/company/111278956"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","latex":false},"integrations":{"posthog":{"apiKey":"phc_pC7W69jal6F4Dq8c20pId4jqyuaLa4JcdNqH631vEQ","apiHost":"https://p.tikk.chat","sessionRecording":true}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tikk","hasAudioNarration":false,"actualSubdomain":"tikk","customDomains":["docs.tikk.chat"],"gitSource":{"type":"github","owner":"whitespacecode","repo":"tikk-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af6e9cd29222d23132a6c7f","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Services","count":5},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Bookings","count":2},{"language":"default","tag":"Plans \u0026 Billing","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button span.bg-primary-dark{background:#000!important}img[alt~=\"logo\"]{height:40px!important}"}],"page":{"pagePath":"api-reference/services/list-services","slug":"/api-reference/services/list-services","pageMetadata":{"title":"List your services","openapi":"api-reference/openapi.yaml GET /services","description":"Lists your services of one type, paginated. Without `type` you get your\ndefault services: the ones visitors can book right now, which means\nactive and within your plan's service limit, with the `is_default` one\nfirst. Single-use services are listed newest first, whatever their\nstatus.\n\n**Scope:** `services.read`\n","href":"/api-reference/services/list-services"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Lists your services of one type, paginated. Without \", _jsx(_components.code, {\n children: \"type\"\n }), \" you get your\\ndefault services: the ones visitors can book right now, which means\\nactive and within your plan’s service limit, with the \", _jsx(_components.code, {\n children: \"is_default\"\n }), \" one\\nfirst. Single-use services are listed newest first, whatever their\\nstatus.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"services.read\"\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Note,Table}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every service has a `,_jsx(_components.code,{children:`type`}),`:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`default`})}),_jsx(_components.td,{children:`A permanent booking page, such as “Intro call”.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`single_use`})}),_jsx(_components.td,{children:`A private booking link for one person, spent once it’s booked. Bookings through it are accepted and never paid.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Don’t confuse `,_jsx(_components.code,{children:`type: \"default\"`}),` with `,_jsx(_components.code,{children:`is_default`}),`. `,_jsx(_components.code,{children:`is_default`}),` marks the one\nservice your booking page highlights.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List your services","openapi":"api-reference/openapi.yaml GET /services","description":"Lists your services of one type, paginated. Without `type` you get your\ndefault services: the ones visitors can book right now, which means\nactive and within your plan's service limit, with the `is_default` one\nfirst. Single-use services are listed newest first, whatever their\nstatus.\n\n**Scope:** `services.read`\n","href":"/api-reference/services/list-services"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listServices","summary":"List your services","description":"Lists your services of one type, paginated. Without `type` you get your\ndefault services: the ones visitors can book right now, which means\nactive and within your plan's service limit, with the `is_default` one\nfirst. Single-use services are listed newest first, whatever their\nstatus.\n\n**Scope:** `services.read`\n","tags":["Services"],"security":["276f19b0-ed96-4da8-b4dc-c6a8b910396b"],"parameters":["3f3cc09e-feb0-4704-bed8-cf723daaefed","eab0d8be-059b-4bb5-a077-d0969d11a34d","bc0a41be-87fd-4583-98d9-0114604c191c"],"responses":{"200":"e75126d8-0142-47d1-bea4-4249e561f276","401":"6584aeed-418c-4119-a581-e160c397b623","403":"83fc66d2-99c4-4aef-aae6-b707efb4a8e4","422":"769cce48-4e56-4c2a-8db2-8dc7e305a8a0","429":"ad5deee1-7227-44eb-aae5-9ba2e465ca7d"},"method":"get","type":"path","servers":["0c4fdfa4-7901-463a-b4ff-6e1fdaaedbcd"],"path":"/services","baseUrlOptions":["https://app.tikk.chat/api/v1"],"title":"List your services","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3f3cc09e-feb0-4704-bed8-cf723daaefed":{"name":"type","in":"query","required":false,"description":"Which type of service to list.","schema":{"type":"string","enum":["default","single_use"],"default":"default","isRequired":false,"description":"Which type of service to list.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"eab0d8be-059b-4bb5-a077-d0969d11a34d":{"name":"per_page","in":"query","required":false,"description":"Results per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"isRequired":false,"description":"Results per page.","uniqueKey":"","typeLabel":"integer"}},"bc0a41be-87fd-4583-98d9-0114604c191c":{"name":"page","in":"query","required":false,"description":"Page to return.","schema":{"type":"integer","minimum":1,"default":1,"isRequired":false,"description":"Page to return.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"e75126d8-0142-47d1-bea4-4249e561f276":{"description":"A page of services.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this credential.","schema":{"type":"integer","example":60}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer","example":59}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Services of the requested type.","items":{"oneOf":[{"type":"object","title":"Default service","description":"A permanent booking page, such as \"Intro call\".","required":["type","id","slug","title","description","is_default","is_group","max_attendees","requires_approval","durations","location","embed_url"],"properties":{"type":{"type":"string","const":"default","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.type","typeLabel":"string"},"id":{"type":"integer","description":"Pass it to `/services/{id}`, as `service` on `/availability`, and as `service` on `POST /services` to copy it into a single-use service.","example":48213,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.id","typeLabel":"integer"},"slug":{"type":"string","description":"The last segment of the service's booking URL.","example":"intro-call","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.slug","typeLabel":"string"},"title":{"type":"string","example":"Intro call","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Shown on the booking page.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shown on the booking page.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.description","typeLabel":"string | null"},"is_default":{"type":"boolean","description":"`true` for the one service your booking page highlights. Not the same as `type: default`.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.is_default","typeLabel":"boolean"},"is_group":{"type":"boolean","description":"`true` if several people can book the same slot.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.is_group","typeLabel":"boolean"},"max_attendees":{"oneOf":[{"type":"integer","description":"Seat cap for a group service. `null` otherwise.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.max_attendees.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Seat cap for a group service. `null` otherwise.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.max_attendees.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.max_attendees","typeLabel":"integer | null"},"requires_approval":{"type":"boolean","description":"`true` if you accept each booking by hand.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.requires_approval","typeLabel":"boolean"},"durations":{"type":"array","description":"The durations a booker can pick.","items":{"type":"object","properties":{"minutes":{"type":"integer","description":"Length in minutes.","example":30,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX].minutes","typeLabel":"integer"},"price":{"oneOf":[{"type":"integer","description":"Price in minor currency units, so `7500` is €75.00. `null` when free. Always `null` on single-use services, which are never paid.","example":7500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX].price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price in minor currency units, so `7500` is €75.00. `null` when free. Always `null` on single-use services, which are never paid.","example":7500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX].price","typeLabel":"integer | null"},"currency":{"type":"string","description":"ISO 4217 code. Always `EUR`.","example":"EUR","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX].currency","typeLabel":"string"}},"required":["minutes","price","currency"],"uniqueKey":"data.items.[INDEX].oneOf.0.durations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.durations","typeLabel":"object[]"},"location":{"oneOf":[{"type":"object","description":"Where the meeting takes place.","required":["type","label","address"],"properties":{"type":{"type":"string","enum":["video","in_person","none"],"example":"video","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.type","typeLabel":"enum\u003cstring>"},"label":{"type":"string","description":"Human-readable name of the location type.","example":"Video Meeting","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.label","typeLabel":"string"},"address":{"oneOf":[{"type":"string","description":"Only when you show the address publicly. `null` otherwise.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.address.oneOf.0","typeLabel":"string"},{"type":"null","description":"Only when you show the address publicly. `null` otherwise.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.address","typeLabel":"string | null"},"meeting_provider":{"oneOf":[{"type":"string","enum":["google_meet","teams","jitsi","whereby","zoom","proton_meet","jitsi_room",null],"description":"The video tool this service uses. `google_meet`, `teams` and `jitsi` create a new room per booking; the others use the fixed room in `meeting_link`. `null` uses the account's meeting settings. Only set for `video` locations.","example":"whereby","uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_provider.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["google_meet","teams","jitsi","whereby","zoom","proton_meet","jitsi_room",null],"description":"The video tool this service uses. `google_meet`, `teams` and `jitsi` create a new room per booking; the others use the fixed room in `meeting_link`. `null` uses the account's meeting settings. Only set for `video` locations.","example":"whereby","uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_provider","typeLabel":"enum\u003cstring> | null"},"meeting_link":{"oneOf":[{"type":"string","format":"uri","description":"The fixed room link sent to everyone who books. `null` for tools that create a room per booking.","example":"https://whereby.com/your-room","uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_link.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The fixed room link sent to everyone who books. `null` for tools that create a room per booking.","example":"https://whereby.com/your-room","uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0.meeting_link","typeLabel":"string\u003curi> | null"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.0","typeLabel":"object"},{"type":"null","description":"Where the meeting takes place.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.location","typeLabel":"object | null"},"embed_url":{"oneOf":[{"type":"string","format":"uri","description":"The service's booking URL. `null` until you pick a username.","example":"https://tikk.chat/jane/intro-call","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.embed_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The service's booking URL. `null` until you pick a username.","example":"https://tikk.chat/jane/intro-call","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.embed_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.embed_url","typeLabel":"string\u003curi> | null"}},"uniqueKey":"data.items.[INDEX].oneOf.0","typeLabel":"Default service · object"},{"type":"object","title":"Single-use service","description":"A private booking link for one person, spent once it's booked. Bookings made through one are accepted straight away and never paid.","required":["type","id","title","description","status","url","contact","durations","expires_at","created_at"],"properties":{"type":{"type":"string","const":"single_use","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.type","typeLabel":"string"},"id":{"type":"integer","description":"Pass it to `GET` and `DELETE /services/{id}`, and as `service` on `/availability`.","example":73920,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.id","typeLabel":"integer"},"title":{"type":"string","description":"Name of the link.","example":"Intro call for Sam Smith","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Note shown at the top of the booking page.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Note shown at the top of the booking page.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.description","typeLabel":"string | null"},"status":{"type":"string","enum":["open","used","expired","disabled"],"description":"`open` can be booked. `used` has been booked and no longer works.\n`expired` passed `expires_at` without a booking. `disabled` was\nswitched off in Tikk. A used link stays `used`, even after it\nexpires or is switched off.\n","example":"open","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"url":{"oneOf":[{"type":"string","format":"uri","description":"The private link to send. `null` until you pick a username.","example":"https://tikk.chat/jane/Xk3pQ9aB2c/intro-call-for-sam-smith","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The private link to send. `null` until you pick a username.","example":"https://tikk.chat/jane/Xk3pQ9aB2c/intro-call-for-sam-smith","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.url","typeLabel":"string\u003curi> | null"},"contact":{"oneOf":[{"type":"object","description":"Who the link is for. `null` when no contact was given.","required":["name","email"],"properties":{"name":{"oneOf":[{"type":"string","example":"Sam Smith","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Sam Smith","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","format":"email","example":"sam@example.com","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","example":"sam@example.com","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0.email","typeLabel":"string\u003cemail> | null"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.0","typeLabel":"object"},{"type":"null","description":"Who the link is for. `null` when no contact was given.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.contact","typeLabel":"object | null"},"durations":{"type":"array","description":"The offered durations.","items":{"type":"object","properties":{"minutes":{"type":"integer","description":"Length in minutes.","example":30,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX].minutes","typeLabel":"integer"},"price":{"oneOf":[{"type":"integer","description":"Price in minor currency units, so `7500` is €75.00. `null` when free. Always `null` on single-use services, which are never paid.","example":7500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX].price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price in minor currency units, so `7500` is €75.00. `null` when free. Always `null` on single-use services, which are never paid.","example":7500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX].price","typeLabel":"integer | null"},"currency":{"type":"string","description":"ISO 4217 code. Always `EUR`.","example":"EUR","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX].currency","typeLabel":"string"}},"required":["minutes","price","currency"],"uniqueKey":"data.items.[INDEX].oneOf.1.durations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.durations","typeLabel":"object[]"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the link stops working.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the link stops working.","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.expires_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.created_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.items.[INDEX].oneOf.1","typeLabel":"Single-use service · object"}],"uniqueKey":"data.items.[INDEX]","typeLabel":"Default service · object | Single-use service · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"(Default service · object | Single-use service · object)[]"},"links":{"type":"object","properties":{"first":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"links.first.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"links.first.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"links.first","typeLabel":"string\u003curi> | null"},"last":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"links.last.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"links.last.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"links.last","typeLabel":"string\u003curi> | null"},"prev":{"oneOf":[{"type":"string","format":"uri","description":"`null` on the first page.","isRequired":true,"uniqueKey":"links.prev.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"`null` on the first page.","isRequired":true,"uniqueKey":"links.prev.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"links.prev","typeLabel":"string\u003curi> | null"},"next":{"oneOf":[{"type":"string","format":"uri","description":"`null` on the last page.","isRequired":true,"uniqueKey":"links.next.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"`null` on the last page.","isRequired":true,"uniqueKey":"links.next.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"links.next","typeLabel":"string\u003curi> | null"}},"required":["first","last","prev","next"],"isRequired":true,"uniqueKey":"links","typeLabel":"object"},"meta":{"type":"object","properties":{"current_page":{"type":"integer","example":1,"isRequired":true,"uniqueKey":"meta.current_page","typeLabel":"integer"},"from":{"oneOf":[{"type":"integer","description":"Position of the first result on this page.","example":1,"isRequired":true,"uniqueKey":"meta.from.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Position of the first result on this page.","example":1,"isRequired":true,"uniqueKey":"meta.from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.from","typeLabel":"integer | null"},"last_page":{"type":"integer","example":4,"isRequired":true,"uniqueKey":"meta.last_page","typeLabel":"integer"},"links":{"type":"array","description":"Numbered pager links, for building a page-number UI.","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"meta.links.items.[INDEX].url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"meta.links.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.links.items.[INDEX].url","typeLabel":"string\u003curi> | null"},"label":{"type":"string","uniqueKey":"meta.links.items.[INDEX].label","typeLabel":"string"},"active":{"type":"boolean","uniqueKey":"meta.links.items.[INDEX].active","typeLabel":"boolean"}},"uniqueKey":"meta.links.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"meta.links","typeLabel":"object[]"},"path":{"type":"string","format":"uri","description":"The endpoint URL without query parameters.","isRequired":true,"uniqueKey":"meta.path","typeLabel":"string\u003curi>"},"per_page":{"type":"integer","example":25,"isRequired":true,"uniqueKey":"meta.per_page","typeLabel":"integer"},"to":{"oneOf":[{"type":"integer","description":"Position of the last result on this page.","example":25,"isRequired":true,"uniqueKey":"meta.to.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Position of the last result on this page.","example":25,"isRequired":true,"uniqueKey":"meta.to.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.to","typeLabel":"integer | null"},"total":{"type":"integer","description":"Results across all pages.","example":87,"isRequired":true,"uniqueKey":"meta.total","typeLabel":"integer"}},"required":["current_page","from","last_page","links","path","per_page","to","total"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","links","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","summary":"Default services","value":{"data":[{"type":"default","id":48213,"slug":"intro-call","title":"Intro call","description":"A first chat to see if we're a fit.","is_default":true,"is_group":false,"max_attendees":null,"requires_approval":true,"durations":[{"minutes":30,"price":null,"currency":"EUR"},{"minutes":60,"price":7500,"currency":"EUR"}],"location":{"type":"video","label":"Video Meeting","address":null},"embed_url":"https://tikk.chat/jane/intro-call"}],"links":{"first":"https://app.tikk.chat/api/v1/services?page=1","last":"https://app.tikk.chat/api/v1/services?page=1","prev":null,"next":null},"meta":{"current_page":1,"from":1,"last_page":1,"links":[],"path":"https://app.tikk.chat/api/v1/services","per_page":25,"to":1,"total":1}}}},"exampleType":"examples"}},"exampleType":"examples"},"6584aeed-418c-4119-a581-e160c397b623":{"description":"No credential was sent, or it's revoked, expired or unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"What went wrong. Branch on the status code, not on this text.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Unauthenticated."},"examples":{"Example":{"title":"Example","value":{"message":"Unauthenticated."}}},"exampleType":"examples"}},"exampleType":"examples"},"83fc66d2-99c4-4aef-aae6-b707efb4a8e4":{"description":"The credential doesn't carry the scope this endpoint needs.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Missing required scope.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"scopes":{"type":"array","description":"The scope or scopes the endpoint needs.","items":{"type":"string","uniqueKey":"scopes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"scopes","typeLabel":"string[]"}},"required":["message","scopes"],"uniqueKey":"","typeLabel":"object"},"examples":{"missingScope":{"title":"missingScope","summary":"Missing scope","value":{"message":"Missing required scope.","scopes":["services.write"]}}},"exampleType":"examples"}},"exampleType":"examples"},"769cce48-4e56-4c2a-8db2-8dc7e305a8a0":{"description":"One or more parameters failed validation.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The to field must be a date after or equal to from.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"Failed rules, keyed by parameter name.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"to":["The to field must be a date after or equal to from."]},"isRequired":true,"uniqueKey":"errors","typeLabel":"object"}},"required":["message","errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The to field must be a date after or equal to from.","errors":{"to":["The to field must be a date after or equal to from."]}}}},"exampleType":"generated"}},"exampleType":"generated"},"ad5deee1-7227-44eb-aae5-9ba2e465ca7d":{"description":"More than 60 requests in a minute for this credential.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"What went wrong. Branch on the status code, not on this text.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Too Many Attempts."},"examples":{"Example":{"title":"Example","value":{"message":"Too Many Attempts."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"276f19b0-ed96-4da8-b4dc-c6a8b910396b":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key from **Settings → API Keys** (starts with `tikk_sk_`), or an\nOAuth access token for a partner app. Both carry scopes; each endpoint\nlists the one it needs.\n","scopes":["services.read"],"schemeName":"bearerAuth"}}},"servers":{"0c4fdfa4-7901-463a-b4ff-6e1fdaaedbcd":{"url":"https://app.tikk.chat/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from **Settings → API Keys** (starts with `tikk_sk_`), or an\nOAuth access token for a partner app. Both carry scopes; each endpoint\nlists the one it needs.\n","scopes":["services.read"],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from **Settings → API Keys** (starts with `tikk_sk_`), or an\nOAuth access token for a partner app. Both carry scopes; each endpoint\nlists the one it needs.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"tikk","siteName":"Tikk","title":"List your services - Tikk","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T13:53:07.774Z","originalFileLocation":"api-reference/services/list-services.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Lists your services of one type, paginated. Without type you get your default services: the ones visitors can book right now, which means active and within your plan\u0026#x27;s service limit, with the is_default one first. Single-use services are listed newest first, whatever their status. Scope: services.read\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tikk\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List your services - Tikk\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists your services of one type, paginated. Without type you get your default services: the ones visitors can book right now, which means active and within your plan\u0026#x27;s service limit, with the is_default one first. Single-use services are listed newest first, whatever their status. Scope: services.read\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tikk\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tikk.chat/api-reference/services/list-services\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tikk.mintlify.site/_mintlify/api/og/v2?division=Services\u0026amp;title=List+your+services\u0026amp;description=Lists+your+services+of+one+type%2C+paginated.+Without+%60type%60+you+get+your%0Adefault+services%3A+the+ones+visitors+can+book+right+now%2C+which+means%0Aactive+and+within+yo\u0026amp;theme=f5439b58138018aeb9a1e01e\u0026amp;signature=bab8ba601a3e3eda6472467e63db076f176727df242e1208c476209a2188d4ad\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List your services - Tikk\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists your services of one type, paginated. Without type you get your default services: the ones visitors can book right now, which means active and within your plan\u0026#x27;s service limit, with the is_default one first. Single-use services are listed newest first, whatever their status. Scope: services.read\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tikk.mintlify.site/_mintlify/api/og/v2?division=Services\u0026amp;title=List+your+services\u0026amp;description=Lists+your+services+of+one+type%2C+paginated.+Without+%60type%60+you+get+your%0Adefault+services%3A+the+ones+visitors+can+book+right+now%2C+which+means%0Aactive+and+within+yo\u0026amp;theme=f5439b58138018aeb9a1e01e\u0026amp;signature=bab8ba601a3e3eda6472467e63db076f176727df242e1208c476209a2188d4ad\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tikk/6kYDnd2notRapCRL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tikk\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#848484\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tikk.chat/api-reference/services/list-services\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/services/list-services.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tikk.chat/#organization\",\"name\":\"Tikk\",\"url\":\"https://docs.tikk.chat\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tikk/V1Cxv-mnTLJxEuos/images/logo.svg?fit=max\u0026auto=format\u0026n=V1Cxv-mnTLJxEuos\u0026q=85\u0026s=3c872a88f73e2a482351b0af4a8f9664\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tikk.chat#website\",\"name\":\"Tikk\",\"url\":\"https://docs.tikk.chat\",\"publisher\":{\"@id\":\"https://docs.tikk.chat/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tikk.chat/api-reference/services/list-services#webpage\",\"url\":\"https://docs.tikk.chat/api-reference/services/list-services\",\"name\":\"List your services\",\"description\":\"Lists your services of one type, paginated. Without type you get your default services: the ones visitors can book right now, which means active and within your plan's service limit, with the is_default one first. Single-use services are listed newest first, whatever their status. Scope: services.read\",\"dateModified\":\"2026-11-12T13:53:07.774Z\",\"isPartOf\":{\"@id\":\"https://docs.tikk.chat#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tikk.chat/api-reference/services/list-services#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tikk.chat/api-reference/services/list-services#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tikk\",\"item\":\"https://docs.tikk.chat\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List your services\",\"item\":\"https://docs.tikk.chat/api-reference/services/list-services\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tikk.chat/api-reference/services/list-services#apireference\",\"headline\":\"List your services\",\"name\":\"List your services\",\"description\":\"Lists your services of one type, paginated. Without type you get your default services: the ones visitors can book right now, which means active and within your plan's service limit, with the is_default one first. Single-use services are listed newest first, whatever their status. Scope: services.read\",\"url\":\"https://docs.tikk.chat/api-reference/services/list-services\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tikk.chat/api-reference/services/list-services#webpage\"},\"dateModified\":\"2026-11-12T13:53:07.774Z\",\"publisher\":{\"@id\":\"https://docs.tikk.chat/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tikk.chat#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tikk\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tikk\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/services/list-services.md","siteName":"Tikk","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Tikk REST API. Profile, services, availability and bookings","sidebarTitle":"Overview","href":"/api-reference/introduction"},{"title":"API authentication. API keys and OAuth tokens","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"API scopes. Access permissions for each endpoint","sidebarTitle":"Scopes","href":"/api-reference/scopes"},{"title":"API errors and HTTP status codes","sidebarTitle":"Errors","href":"/api-reference/errors"}]},{"group":"Profile","icon":"user","pages":[{"title":"Get your profile","openapi":"api-reference/openapi.yaml GET /profile","description":"Returns your public profile and plan. Services have their own endpoint,\n[`GET /services`](/api-reference/services/list-services).\n\n**Scope:** `profile.read`\n","href":"/api-reference/profile/get-profile"}]},{"group":"Services","icon":"layers","pages":[{"title":"List your services","openapi":"api-reference/openapi.yaml GET /services","href":"/api-reference/services/list-services"},{"title":"Get a service","openapi":"api-reference/openapi.yaml GET /services/{id}","description":"Returns one service of either type. Fields that don't apply to a type\nare left out rather than set to `null`. A default service that isn't\nbookable right now returns `404`.\n\n**Scope:** `services.read`\n","href":"/api-reference/services/get-service"},{"title":"Create a service","openapi":"api-reference/openapi.yaml POST /services","href":"/api-reference/services/create-service"},{"title":"Edit a default service","openapi":"api-reference/openapi.yaml PATCH /services/{id}","href":"/api-reference/services/update-service"},{"title":"Delete a service","openapi":"api-reference/openapi.yaml DELETE /services/{id}","href":"/api-reference/services/delete-service"}]},{"group":"Availability","icon":"calendar","pages":[{"title":"List your free time slots","openapi":"api-reference/openapi.yaml GET /availability","href":"/api-reference/availability/list-availability"}]},{"group":"Bookings","icon":"list","pages":[{"title":"List your bookings","openapi":"api-reference/openapi.yaml GET /bookings","href":"/api-reference/bookings/list-bookings"},{"title":"Get a booking","openapi":"api-reference/openapi.yaml GET /bookings/{id}","href":"/api-reference/bookings/get-booking"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks. Booking updates pushed to your URL","sidebarTitle":"Webhooks","href":"/api-reference/webhooks"},{"title":"List your webhooks","openapi":"api-reference/openapi.yaml GET /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create a webhook","openapi":"api-reference/openapi.yaml POST /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get a webhook","openapi":"api-reference/openapi.yaml GET /webhooks/{id}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update a webhook","openapi":"api-reference/openapi.yaml PATCH /webhooks/{id}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete a webhook","openapi":"api-reference/openapi.yaml DELETE /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook"}]}]}]},"basePath":"","title":"List your services - Tikk","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}