> ## 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-v2/exercisedb-v2.json get /api/v1/exercises/{exerciseId} openapi: 3.1.0 info: version: 1.0.0 title: EXERCISEDB V2 API description: >- EXERCISEDB V2 is a comprehensive, multipurpose exercise dataset designed for production-grade fitness applications. With 11,000+ structured exercises, 15,000+ demonstration videos, and 20,000+ images, it provides everything developers need to build rich, data-driven fitness experiences. Each exercise includes detailed muscle targeting, secondary muscle engagement, required equipment, exercise type classification, step-by-step instructions, pro tips, exercise variations, and related exercise recommendations. Media is served through a fast CDN in multiple resolutions from 360p to 1080p, with video demonstrations included for every exercise. Built for a wide range of use cases including fitness apps, physiotherapy platforms, personal training tools, workout planners, strength training programs, and educational health platforms. ## 🔗 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-videos-and-images-by-ascendapi) | | GitHub | [github.com/exercisedb](https://github.com/exercisedb/exercisedb-api) | **Built with ❤️ by [AscendAPI](https://www.ascendapi.com)** servers: - url: https://edb-with-videos-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 description: The unique identifier of the exercise to retrieve. title: Exercise ID example: exr_41n2hxnFMotsXTj3 default: exr_41n2hxnFMotsXTj3 required: true 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: exr_41n2hxnFMotsXTj3 name: type: string description: The name of the exercise. example: Bench Press equipments: type: array items: type: string description: List of equipment required for the exercise. example: - Barbell bodyParts: type: array items: type: string description: Primary body parts targeted by the exercise. example: - Chest exerciseType: type: string description: Type of exercise (e.g., strength, cardio). example: strength targetMuscles: type: array items: type: string description: Primary muscles targeted by the exercise. example: - Pectoralis Major Clavicular Head secondaryMuscles: type: array items: type: string description: Secondary muscles engaged during the exercise. example: - Deltoid Anterior - Pectoralis Major Clavicular Head - Triceps Brachii keywords: type: array items: type: string description: >- Keywords associated with the exercise for searchability. example: - Chest workout with barbell - Barbell bench press exercise - Strength training for chest - Upper body workout with barbell - Barbell chest exercises - Bench press for chest muscles - Building chest muscles with bench press - Chest strengthening with barbell - Bench press workout routine - Barbell exercises for chest muscle growth 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: - >- 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. exerciseTips: type: array items: type: string description: Tips to perform the exercise safely and effectively. example: - >- Avoid Arching Your Back: One common mistake is excessively arching the back during the lift. This can lead to lower back injuries. Your lower back should have a natural arch, but it should not be overly exaggerated. Your butt, shoulders, and head should maintain contact with the bench at all times. - >- Controlled Movement: Avoid the temptation to lift the barbell too quickly. A controlled, steady lift is more effective and reduces the risk of injury. Lower the bar to your mid-chest slowly, pause briefly, then push it back up without locking your elbows at the top. - 'Don''t Lift Alone:' variations: type: array items: type: string description: >- Variations of the exercise to target different muscles or equipment. example: - >- Decline Bench Press: This variation is performed on a decline bench to target the lower part of the chest. - >- Close-Grip Bench Press: This variation focuses on the triceps and the inner part of the chest by placing the hands closer together on the bar. - >- Dumbbell Bench Press: This variation uses dumbbells instead of a barbell, allowing for a greater range of motion and individual arm movement. - >- Reverse-Grip Bench Press: This variation is performed by flipping your grip so that your palms face towards you, targeting the upper chest and triceps. relatedExerciseIds: type: array items: type: string description: IDs of related exercises. example: - exr_41n2hPFTn4fEG8Bx - exr_41n2hfGATUH6QYu5 - exr_41n2hYxxWAwXX57z - exr_41n2heKDPVZrnq5Y - exr_41n2hM1MEG81baQX - exr_41n2hjhUQ3cXvDpe - exr_41n2hNpnikEpEu7g - exr_41n2htZnfjAfHeum - exr_41n2hKxRy59v8iGj - exr_41n2hU3GCnWWS86T videoUrl: type: string title: videoUrl of exercises imageUrl: type: string title: imageUrl of exercises imageUrls: type: object properties: 360p: type: string 480p: type: string 720p: type: string 1080p: type: string description: >- An object mapping resolution keys (e.g., 360p, 480p, 720p, 1080p) to URLs for static images of the exercise. title: Image URLs of exercises example: 360p: >- https://cdn.exercisedb.dev/media/w/images/ZVZe7lmc7O.jpg 480p: >- https://cdn.exercisedb.dev/media/w/images/cuG10rd4ea.jpg 720p: >- https://cdn.exercisedb.dev/media/w/images/6LcxUaf0CU.jpg 1080p: >- https://cdn.exercisedb.dev/media/w/images/IoEuhBCISH.jpg required: - exerciseId - name - equipments - bodyParts - exerciseType - targetMuscles - secondaryMuscles - keywords - overview - instructions - exerciseTips - variations description: Exercise data title: Retrive Exercise by id 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. ````