The endpoint for listing athletes allows for the use of arbitrary query parameters that you define based on your needs. For instance, if your organization uses custom attributes for athletes, you can pass those attributes directly in the query string.Examples of custom attributes might include:
sport=MLB
team=XYZ
age=30
position=center
Or any other custom attribute based on your organization’s data.
These custom parameters allow you to filter athletes more precisely based on your unique dataset.
To learn more about how to properly filter athletes using custom attributes and query parameters, check out examples of Filtering Athletes.
Number of records to retrieve. Maximum valid value is 500. Default is 100. Use with the offset query parameter to paginate and retrieve more than the first 500 results.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Uplift","colors":{"primary":"#cc0000","light":"#f05050","dark":"#cc0000"},"logo":{"light":"https://mintcdn.com/upliftlabs/2HQ-3ZfO0xHhGpxM/images/logo-light.svg?fit=max\u0026auto=format\u0026n=2HQ-3ZfO0xHhGpxM\u0026q=85\u0026s=0fe44b3eed4e573463a85ad1e423173d","dark":"https://mintcdn.com/upliftlabs/2HQ-3ZfO0xHhGpxM/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=2HQ-3ZfO0xHhGpxM\u0026q=85\u0026s=8f9cd45b54d1c5e9686632c5a410de12"},"favicon":"https://mintcdn.com/upliftlabs/iYgjDIzM_IZXat_9/favicon.svg?fit=max\u0026auto=format\u0026n=iYgjDIzM_IZXat_9\u0026q=85\u0026s=967c7cc181c16df8f4ba6f544941f20e","api":{"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://api.uplift.ai/v1"}},"background":{"color":{"light":"#ffffff","dark":"#232426"}},"navbar":{"links":[{"href":"https://www.uplift.ai/validation","label":"Research"},{"href":"https://www.uplift.ai/blog","label":"Blog"},{"href":"https://www.uplift.ai/articles","label":"News"}],"primary":{"type":"button","label":"Sign In","href":"https://platform.uplift.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/upliftlabs","github":"https://github.com/upliftlabs","linkedin":"https://www.linkedin.com/company/upliftlabs"}},"seo":{"indexing":"all"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"upliftlabs","hasAudioNarration":false,"actualSubdomain":"upliftlabs","customDomains":["docs.uplift.ai"],"gitSource":{"type":"github","owner":"upliftlabs","repo":"uplift-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb8c9f194a125071f4423c","collectionId":"b9cd3a52-8596-4124-949a-7f87dedc444a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb8c9f194a125071f4423c"},"entitlements":{},"buildId":"6adb8c9f194a125071f4423c","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Guides","count":43},{"language":"default","tag":"Using Uplift","count":39},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Performing an Assessment","count":15},{"language":"default","tag":"Biomechanics","count":13},{"language":"default","tag":"API Documentation","count":8},{"language":"default","tag":"Platform Configuration","count":6},{"language":"default","tag":"Reviewing Assessment Results","count":6},{"language":"default","tag":"Athletes","count":5},{"language":"default","tag":"Prerequisites","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-as=p]{display:block;margin:0 0 1rem}li>[data-as=p]{display:inline;margin:0}table{table-layout:auto}td:first-child,td:last-child,th{white-space:nowrap}"}],"page":{"pagePath":"api-reference/athletes/list","slug":"/api-reference/athletes/list","pageMetadata":{"title":"List Athletes","openapi":"GET /athletes","description":"Retrieves the information of athletes in an organization.","href":"/api-reference/athletes/list"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieves the information of athletes in an organization.\"\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={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`custom-attributes`,children:`Custom Attributes`}),`\n`,_jsxs(_components.p,{children:[`The endpoint for listing athletes allows for the use of `,_jsx(_components.strong,{children:`arbitrary query parameters`}),` that you define based on your needs. For instance, if your organization uses custom attributes for athletes, you can pass those attributes directly in the query string.`]}),`\n`,_jsx(_components.p,{children:`Examples of custom attributes might include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`sport=MLB`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`team=XYZ`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`age=30`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`position=center`})}),`\n`,_jsx(_components.li,{children:`Or any other custom attribute based on your organization’s data.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`These custom parameters allow you to filter athletes more precisely based on your unique dataset.\nTo learn more about how to properly filter athletes using custom attributes and query parameters, check out examples of `,_jsx(_components.a,{href:`/api-reference/filtering-athletes`,children:`Filtering Athletes`}),`.`]}),`\n`,_jsx(_components.hr,{})]})}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 Athletes","openapi":"GET /athletes","description":"Retrieves the information of athletes in an organization.","href":"/api-reference/athletes/list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Custom Attributes","slug":"custom-attributes","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List Athletes in Organization","description":"Retrieves the information of athletes in an organization.","tags":["Athlete Management"],"parameters":["9963ec18-d863-4dfc-967d-490a54d53964","c6e657b8-346d-42e2-b298-5882bf74a6a8","4561d19b-4756-45a3-aff4-d4c1ff780db5"],"responses":{"200":"a67b02fb-f440-4139-8f9d-c147570c3f3f","400":"0fc11fa5-9cce-42ff-b610-09edd89c5374","401":"c892fb11-54bb-4a43-bfac-63eda1ff4a5d","403":"b54dabd1-f40f-490d-8d0c-c5f5ab336a87","429":"f78be71f-fb05-4de4-92ae-07c70e092fa7","500":"712fa21f-cb6a-4498-b111-9977fdf42594"},"security":["1aa986f1-8b83-46dc-b7c1-87f4361a84f5"],"method":"get","type":"path","servers":["0cd9ad4a-23eb-47b4-92fb-1035511279fc"],"path":"/athletes","baseUrlOptions":["https://api.uplift.ai/v1"],"title":"List Athletes in Organization","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9963ec18-d863-4dfc-967d-490a54d53964":{"name":"offset","in":"query","required":false,"description":"Number of records to skip for pagination. Default is 0. \n\nRead more about [Retrieving Data in Batches](../retrieving-data-batches) for usage examples.","schema":{"type":"integer","default":0,"isRequired":false,"description":"Number of records to skip for pagination. Default is 0. \n\nRead more about [Retrieving Data in Batches](../retrieving-data-batches) for usage examples.","uniqueKey":"","typeLabel":"integer"}},"c6e657b8-346d-42e2-b298-5882bf74a6a8":{"name":"limit","in":"query","required":false,"description":"Number of records to retrieve. Maximum valid value is 500. Default is 100. Use with the offset query parameter to paginate and retrieve more than the first 500 results. \n\nRead more about [Retrieving Data in Batches](../retrieving-data-batches) for usage examples.","schema":{"type":"integer","default":100,"isRequired":false,"description":"Number of records to retrieve. Maximum valid value is 500. Default is 100. Use with the offset query parameter to paginate and retrieve more than the first 500 results. \n\nRead more about [Retrieving Data in Batches](../retrieving-data-batches) for usage examples.","uniqueKey":"","typeLabel":"integer"}},"4561d19b-4756-45a3-aff4-d4c1ff780db5":{"name":"sorted_by","in":"query","required":false,"description":"Sort the records by the specified field in the record. Default is null.","schema":{"type":"string","enum":["first_name","last_name","date_of_birth"],"default":null,"isRequired":false,"description":"Sort the records by the specified field in the record. Default is null.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"a67b02fb-f440-4139-8f9d-c147570c3f3f":{"description":"Successful retrieval of athlete records.","content":{"application/json":{"schema":{"type":"object","properties":{"athletes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the athlete.","uniqueKey":"athletes.items.[INDEX].id","typeLabel":"string"},"first_name":{"type":"string","description":"The first name of the athlete.","uniqueKey":"athletes.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","description":"The last name of the athlete.","uniqueKey":"athletes.items.[INDEX].last_name","typeLabel":"string"},"date_of_birth":{"type":"string","format":"date-time","description":"The date of birth of the athlete.","uniqueKey":"athletes.items.[INDEX].date_of_birth","typeLabel":"string\u003cdate-time>"},"email":{"type":"string","description":"The athlete's email address.","uniqueKey":"athletes.items.[INDEX].email","typeLabel":"string"},"phone":{"type":"string","description":"The athlete's phone number.","uniqueKey":"athletes.items.[INDEX].phone","typeLabel":"string"},"gender":{"type":"string","enum":["male","female","non-binary","prefer_not_to_say"],"description":"The athlete's gender. Allowed values: male, female, non-binary, prefer_not_to_say.","uniqueKey":"athletes.items.[INDEX].gender","typeLabel":"enum\u003cstring>"},"dominant_arm":{"type":"string","enum":["left","right","both"],"description":"Dominant arm. Allowed values: left, right, both.","uniqueKey":"athletes.items.[INDEX].dominant_arm","typeLabel":"enum\u003cstring>"},"dominant_leg":{"type":"string","enum":["left","right","both"],"description":"Dominant leg. Allowed values: left, right, both.","uniqueKey":"athletes.items.[INDEX].dominant_leg","typeLabel":"enum\u003cstring>"},"activity":{"type":"string","enum":["baseball","softball","tennis","basketball","golf"],"description":"Primary sport or activity. Allowed values: baseball, softball, tennis, basketball, golf.","uniqueKey":"athletes.items.[INDEX].activity","typeLabel":"enum\u003cstring>"},"positions":{"type":"array","items":{"type":"string","uniqueKey":"athletes.items.[INDEX].positions.items.[INDEX]","typeLabel":"string"},"description":"Positions for the athlete's activity. Requires activity to be set. Allowed values depend on activity: baseball and softball: pitcher, catcher, first_base, second_base, third_base, shortstop, left_field, center_field, right_field, designated_hitter. basketball: point_guard, shooting_guard, small_forward, power_forward, center. tennis and golf have no positions.","uniqueKey":"athletes.items.[INDEX].positions","typeLabel":"string[]"},"competition_level":{"type":"string","enum":["youth","high_school","college","professional"],"description":"Competition level. Allowed values: youth, high_school, college, professional.","uniqueKey":"athletes.items.[INDEX].competition_level","typeLabel":"enum\u003cstring>"},"height":{"type":"integer","description":"The height of the athlete, in inches.","uniqueKey":"athletes.items.[INDEX].height","typeLabel":"integer"},"weight":{"type":"integer","description":"The weight of the athlete, in pounds (lbs).","uniqueKey":"athletes.items.[INDEX].weight","typeLabel":"integer"},"custom_attributes":{"type":"object","description":"A set of custom key-value attributes. Keys must be strings, and values must also be strings.","additionalProperties":{"type":"string","uniqueKey":"athletes.items.[INDEX].custom_attributes.additionalProperties","typeLabel":"string"},"uniqueKey":"athletes.items.[INDEX].custom_attributes","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"The timestamp when the athlete record was created.","uniqueKey":"athletes.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"The timestamp when the athlete record was last updated.","uniqueKey":"athletes.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"athletes.items.[INDEX]","typeLabel":"object"},"description":"The list of athlete records retrieved.","uniqueKey":"athletes","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"athletes":[{"id":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","date_of_birth":"2023-11-07T05:31:56Z","email":"\u003cstring>","phone":"\u003cstring>","gender":"male","dominant_arm":"left","dominant_leg":"left","activity":"baseball","positions":["\u003cstring>"],"competition_level":"youth","height":123,"weight":123,"custom_attributes":{},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0fc11fa5-9cce-42ff-b610-09edd89c5374":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A short error code representing the type of error.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"A detailed message explaining the error.","uniqueKey":"message","typeLabel":"string"},"messages":{"type":"string","description":"Create Capture only: validation detail. Multiple issues are joined with `; `.","uniqueKey":"messages","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"BadRequest","message":"The request parameters are invalid. Please review the request and try again."},"examples":{"Example":{"title":"Example","value":{"error":"BadRequest","message":"The request parameters are invalid. Please review the request and try again."}}},"exampleType":"examples"}},"exampleType":"examples"},"c892fb11-54bb-4a43-bfac-63eda1ff4a5d":{"description":"Unauthorized. Bearer token is missing or invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A short error code representing the type of error.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"A detailed message explaining the error.","uniqueKey":"message","typeLabel":"string"},"messages":{"type":"string","description":"Create Capture only: validation detail. Multiple issues are joined with `; `.","uniqueKey":"messages","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized","message":"Bearer token is missing or invalid."},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized","message":"Bearer token is missing or invalid."}}},"exampleType":"examples"}},"exampleType":"examples"},"b54dabd1-f40f-490d-8d0c-c5f5ab336a87":{"description":"Forbidden. You do not have permission to access this resource.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A short error code representing the type of error.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"A detailed message explaining the error.","uniqueKey":"message","typeLabel":"string"},"messages":{"type":"string","description":"Create Capture only: validation detail. Multiple issues are joined with `; `.","uniqueKey":"messages","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Forbidden","message":"You do not have permission to access this resource."},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden","message":"You do not have permission to access this resource."}}},"exampleType":"examples"}},"exampleType":"examples"},"f78be71f-fb05-4de4-92ae-07c70e092fa7":{"description":"Too Many Requests. The rate limit has been exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A short error code representing the type of error.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"A detailed message explaining the error.","uniqueKey":"message","typeLabel":"string"},"messages":{"type":"string","description":"Create Capture only: validation detail. Multiple issues are joined with `; `.","uniqueKey":"messages","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"TooManyRequests","message":"The rate limit has been exceeded. Please wait and try again later."},"examples":{"Example":{"title":"Example","value":{"error":"TooManyRequests","message":"The rate limit has been exceeded. Please wait and try again later."}}},"exampleType":"examples"}},"exampleType":"examples"},"712fa21f-cb6a-4498-b111-9977fdf42594":{"description":"Internal Server Error. Something went wrong on the server.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A short error code representing the type of error.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"A detailed message explaining the error.","uniqueKey":"message","typeLabel":"string"},"messages":{"type":"string","description":"Create Capture only: validation detail. Multiple issues are joined with `; `.","uniqueKey":"messages","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"InternalServerError","message":"An unexpected error occurred on the server. Please try again later."},"examples":{"Example":{"title":"Example","value":{"error":"InternalServerError","message":"An unexpected error occurred on the server. Please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"1aa986f1-8b83-46dc-b7c1-87f4361a84f5":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"0cd9ad4a-23eb-47b4-92fb-1035511279fc":{"url":"https://api.uplift.ai/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"upliftlabs","siteName":"Uplift","title":"List Athletes - Uplift","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-09-23T19:43:45.917Z","originalFileLocation":"api-reference/athletes/list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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=\"Retrieves the information of athletes in an organization.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Uplift\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_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/upliftlabs/jReZgUPj-tVlx28s/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Athletes - Uplift\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves the information of athletes in an organization.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Uplift\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.uplift.ai/api-reference/athletes/list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://upliftlabs.mintlify.app/_mintlify/api/og/v2?division=Athletes\u0026amp;title=List+Athletes\u0026amp;description=Retrieves+the+information+of+athletes+in+an+organization.\u0026amp;theme=8fe981e375795c18f8bb5aba\u0026amp;signature=5a8c19e4da56a23a0b7cb58c9f4c9f0b94b1af2ac1c66c3684b2cf64f706901f\">\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 Athletes - Uplift\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves the information of athletes in an organization.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://upliftlabs.mintlify.app/_mintlify/api/og/v2?division=Athletes\u0026amp;title=List+Athletes\u0026amp;description=Retrieves+the+information+of+athletes+in+an+organization.\u0026amp;theme=8fe981e375795c18f8bb5aba\u0026amp;signature=5a8c19e4da56a23a0b7cb58c9f4c9f0b94b1af2ac1c66c3684b2cf64f706901f\">\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/upliftlabs/jReZgUPj-tVlx28s/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Uplift\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#cc0000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.uplift.ai/api-reference/athletes/list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/athletes/list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.uplift.ai/#organization\",\"name\":\"Uplift\",\"url\":\"https://docs.uplift.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/upliftlabs/2HQ-3ZfO0xHhGpxM/images/logo-light.svg?fit=max\u0026auto=format\u0026n=2HQ-3ZfO0xHhGpxM\u0026q=85\u0026s=0fe44b3eed4e573463a85ad1e423173d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.uplift.ai#website\",\"name\":\"Uplift\",\"url\":\"https://docs.uplift.ai\",\"publisher\":{\"@id\":\"https://docs.uplift.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.uplift.ai/api-reference/athletes/list#webpage\",\"url\":\"https://docs.uplift.ai/api-reference/athletes/list\",\"name\":\"List Athletes\",\"description\":\"Retrieves the information of athletes in an organization.\",\"dateModified\":\"2025-09-23T19:43:45.917Z\",\"isPartOf\":{\"@id\":\"https://docs.uplift.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.uplift.ai/api-reference/athletes/list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.uplift.ai/api-reference/athletes/list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Athletes\",\"item\":\"https://docs.uplift.ai/api-reference/athletes/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Athletes\",\"item\":\"https://docs.uplift.ai/api-reference/athletes/list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.uplift.ai/api-reference/athletes/list#apireference\",\"headline\":\"List Athletes\",\"name\":\"List Athletes\",\"description\":\"Retrieves the information of athletes in an organization.\",\"url\":\"https://docs.uplift.ai/api-reference/athletes/list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.uplift.ai/api-reference/athletes/list#webpage\"},\"dateModified\":\"2025-09-23T19:43:45.917Z\",\"publisher\":{\"@id\":\"https://docs.uplift.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.uplift.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Uplift\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Uplift","nav":{"global":null,"anchors":[{"anchor":"Guides","icon":"compass","pages":[{"title":"Guides","href":"/guides/quick-start-guide"}]},{"anchor":"Biomechanics","icon":"angle","pages":[{"title":"Biomechanics","href":"/biomechanics/instructions"}]},{"anchor":"API Reference","icon":"rectangle-terminal","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Retrieving Data in Batches","href":"/api-reference/retrieving-data-batches"},{"title":"Filtering Athletes","href":"/api-reference/filtering-athletes"},{"title":"Filtering Metrics","href":"/api-reference/filtering-metrics"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Sample Apps","href":"/samples/apps"}]},{"group":"Data Export","pages":[{"title":"Create Export Job","openapi":"POST /data/export","href":"/api-reference/data/export/create"},{"title":"Get Job Status","openapi":"GET /data/export/job/{jobId}","href":"/api-reference/data/export/job/get"},{"title":"Get Job Results","openapi":"GET /data/export/job/{jobId}/results","href":"/api-reference/data/export/job/results/get"}]},{"group":"Captures","pages":[{"title":"Create Capture","openapi":"POST /captures","href":"/api-reference/captures/create"},{"title":"List Captures","openapi":"GET /captures","href":"/api-reference/captures/list"},{"title":"Get Capture","openapi":"GET /captures/{captureId}","href":"/api-reference/captures/get"}]},{"group":"Athletes","pages":[{"title":"Create Athlete","openapi":"POST /athletes","href":"/api-reference/athletes/create"},{"title":"Update Athlete","openapi":"POST /athletes/{athleteId}","description":"Use this endpoint to update an athlete's attributes. You can modify all attributes, following specific rules for certain fields and custom attributes. Include only the attributes you wish to update or new custom attributes to add in the request body.","href":"/api-reference/athletes/update"},{"title":"List Athletes","openapi":"GET /athletes","href":"/api-reference/athletes/list"},{"title":"Get Athlete Details","openapi":"GET /athletes/{athleteId}","description":"Retrieves the information of an athlete in an organization.","href":"/api-reference/athletes/get"},{"title":"Delete Athlete","openapi":"DELETE /athletes/{athleteId}","href":"/api-reference/athletes/delete"}]}]},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@uplift.ai"}]},"basePath":"","title":"List Athletes - Uplift","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}