> ## Documentation Index > Fetch the complete documentation index at: https://docs.ascendapi.com/llms.txt > Use this file to discover all available pages before exploring further. # GetExerciseById ## OpenAPI ````yaml /api-reference/exercisedb-v1/exercisedb-v1.json get /api/v1/exercises/{exerciseId} openapi: 3.1.0 info: version: 1.0.0 title: EXERCISEDB V1 description: >- A developer-friendly fitness exercise database featuring over **2,000 structured exercises** with detailed metadata, images, and GIF-based visual aids. ## 🔗 Useful Links: | | | |---|---| | Docs | [docs.ascendapi.com](https://docs.ascendapi.com) | | Website | [ascendapi.com](https://ascendapi.com) | | RapidAPI | [Subscribe Here](https://rapidapi.com/ascendapi/api/edb-with-gifs-and-images-by-ascendapi) | | Free API | [oss.exercisedb.dev](https://oss.exercisedb.dev) | | GitHub | [github.com/exercisedb](https://github.com/exercisedb/exercisedb-api) | **Built with ❤️ by [AscendAPI](https://ascendapi.com)** servers: - url: https://edb-with-gifs-and-images-by-ascendapi.p.rapidapi.com description: |- RapidAPI Production (X-RapidAPI-Key Required) 💼 • Subscription-based plans • Basic → Pro → Ultra → Mega tiers • without rate limits & more data • Reliable production service security: [] paths: /api/v1/exercises/{exerciseId}: get: tags: - exercises summary: GetExerciseById operationId: v1.FetchExerciseByIdApi parameters: - schema: type: string title: Exercise ID description: The unique identifier of the exercise to retrieve. example: edb_T5uXtLj default: edb_T5uXtLj required: true description: The unique identifier of the exercise to retrieve. name: exerciseId in: path responses: '200': description: Retrive Exercise by id content: application/json: schema: type: object properties: success: type: boolean description: Indicates whether the request was successful example: true data: type: object properties: exerciseId: type: string description: The id of the exercise example: edb_T5uXtLj name: type: string description: The name of the exercise. example: barbell bench press bodyParts: type: array items: type: string description: Primary body parts targeted by the exercise. example: - Chest equipments: type: array items: type: string description: List of equipment required for the exercise. example: - Barbell targetMuscles: type: array items: type: string description: Primary muscles targeted by the exercise. example: - pectorals secondaryMuscles: type: array items: type: string description: Secondary muscles engaged during the exercise. example: - shoulders - Triceps exerciseTypes: type: array items: type: string description: Type of exercise (e.g., cardio,strength). example: - strength difficulty: type: string description: Difficulty of exercise (e.g., intermediate). example: intermediate overview: type: string description: Detailed description of the exercise and its benefits. example: >- The Bench Press is a classic strength training exercise that primarily targets the chest, shoulders, and triceps, contributing to upper body muscle development. It is suitable for anyone, from beginners to professional athletes, looking to improve their upper body strength and muscular endurance. Individuals may want to incorporate bench press into their routine for its effectiveness in enhancing physical performance, promoting bone health, and improving body composition. instructions: type: array items: type: string description: Step-by-step instructions to perform the exercise. example: - >- Lie flat on a bench with your feet flat on the ground and your back pressed against the bench. - >- Grip the barbell with your hands slightly wider than shoulder-width apart, palms facing your feet, and lift it off the rack, holding it straight over your chest with your arms fully extended. - >- Slowly lower the barbell down to your chest while keeping your elbows at a 90-degree angle. - >- Once the barbell touches your chest, push it back up to the starting position while keeping your back flat on the bench. - >- Repeat this process for the desired number of repetitions, always maintaining control of the barbell and ensuring your form is correct. relatedExerciseIds: type: array items: type: string description: IDs of related exercises. example: - edb_mbpKFKd - edb_SIiTlYd - edb_TUGkclM - edb_WQUuNhp imageUrls: type: object properties: 360p: type: string 480p: type: string 720p: type: string 1080p: type: string title: Image URLs of exercises description: >- An object mapping resolution keys (e.g., 360p, 480p, 720p, 1080p) to URLs for static images of the exercise. example: 360p: https://assets.exercisedb.dev/media/4txEepQ.png 480p: https://assets.exercisedb.dev/media/2hG9C8W.png 720p: https://assets.exercisedb.dev/media/GiClBZa.png 1080p: https://assets.exercisedb.dev/media/HnVCaEE.png gifUrls: type: object properties: 360p: type: string 480p: type: string 720p: type: string 1080p: type: string title: GIF URLs of exercises description: >- An object mapping resolution keys (e.g., 360p, 480p, 720p,1080p) to URLs for animated GIFs of the exercise. example: 360p: https://assets.exercisedb.dev/media/0Z5iJo9.gif 480p: https://assets.exercisedb.dev/media/ZH4wzSX.gif 720p: https://assets.exercisedb.dev/media/O6hx73x.gif 1080p: https://assets.exercisedb.dev/media/Hk6LRQk.gif required: - exerciseId - name - bodyParts - equipments - targetMuscles - secondaryMuscles - exerciseTypes - difficulty - overview - instructions title: Retrive Exercise by id description: Exercise data required: - success - data '400': description: >- The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). content: application/json: schema: $ref: '#/components/schemas/ErrBadRequest' '401': description: >- Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response. content: application/json: schema: $ref: '#/components/schemas/ErrUnauthorized' '403': description: >- The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server. content: application/json: schema: $ref: '#/components/schemas/ErrForbidden' '404': description: >- The server cannot find the requested resource. In the browser, this means the URL is not recognized. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 Forbidden to hide the existence of a resource from an unauthorized client. This response code is probably the most well known due to its frequent occurrence on the web. content: application/json: schema: $ref: '#/components/schemas/ErrNotFound' '405': description: >- The request method is not supported by the target resource. The server must generate an Allow header field in a 405 response containing a list of the target resource's currently supported methods. content: application/json: schema: $ref: '#/components/schemas/ErrMethodNotAllowed' '409': description: >- This response is sent when a request conflicts with the current state of the server. content: application/json: schema: $ref: '#/components/schemas/ErrConflict' '412': description: >- The requested operation cannot be completed because certain conditions were not met. This typically occurs when a required resource state or version check fails. content: application/json: schema: $ref: '#/components/schemas/ErrPreconditionFailed' '429': description: >- The user has sent too many requests in a given amount of time ("rate limiting") content: application/json: schema: $ref: '#/components/schemas/ErrTooManyRequests' '500': description: >- The server has encountered a situation it does not know how to handle. content: application/json: schema: $ref: '#/components/schemas/ErrInternalServerError' security: - RapidAPIKey: [] components: schemas: ErrBadRequest: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST description: A machine readable error code. example: BAD_REQUEST docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/BAD_REQUEST message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrUnauthorized: type: object properties: error: type: object properties: code: type: string enum: - UNAUTHORIZED description: A machine readable error code. example: UNAUTHORIZED docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/UNAUTHORIZED message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrForbidden: type: object properties: error: type: object properties: code: type: string enum: - FORBIDDEN description: A machine readable error code. example: FORBIDDEN docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/FORBIDDEN message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrNotFound: type: object properties: error: type: object properties: code: type: string enum: - NOT_FOUND description: A machine readable error code. example: NOT_FOUND docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/NOT_FOUND message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrMethodNotAllowed: type: object properties: error: type: object properties: code: type: string enum: - METHOD_NOT_ALLOWED description: A machine readable error code. example: METHOD_NOT_ALLOWED docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/METHOD_NOT_ALLOWED message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrConflict: type: object properties: error: type: object properties: code: type: string enum: - CONFLICT description: A machine readable error code. example: CONFLICT docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/CONFLICT message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrPreconditionFailed: type: object properties: error: type: object properties: code: type: string enum: - PRECONDITION_FAILED description: A machine readable error code. example: PRECONDITION_FAILED docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/PRECONDITION_FAILED message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrTooManyRequests: type: object properties: error: type: object properties: code: type: string enum: - TOO_MANY_REQUESTS description: A machine readable error code. example: TOO_MANY_REQUESTS docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/TOO_MANY_REQUESTS message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error ErrInternalServerError: type: object properties: error: type: object properties: code: type: string enum: - INTERNAL_SERVER_ERROR description: A machine readable error code. example: INTERNAL_SERVER_ERROR docs: type: string description: >- A link to our documentation with more details about this error code example: https://docs.exercisedb.dev/errors/code/INTERNAL_SERVER_ERROR message: type: string description: A human readable explanation of what went wrong requestId: type: string description: Please always include the requestId in your error report example: req_12345 required: - code - docs - message - requestId required: - error securitySchemes: RapidAPIKey: type: apiKey in: header name: X-RapidAPI-Key description: Enter your RapidAPI key in the X-RapidAPI-Key header. ````