> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt # listMedia > List media items attached to a message. List media items (images, files) attached to a message. ### Schema ```yaml openapi: 3.1.0 info: title: API version: 1.0.0 paths: /Accounts/{AccountSid}/Messages/{MessageSid}/Media: get: operationId: list_media summary: List Message Media description: >- List all media for a message. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). tags: - subpackage_messageMedia parameters: - name: AccountSid in: path description: >- The unique identifier of the project that sent or received this message. required: true schema: $ref: '#/components/schemas/uuid' - name: MessageSid in: path description: A unique ID that identifies this specific message. required: true schema: $ref: '#/components/schemas/uuid' - name: DateCreated in: query description: >- Only return media created on this particular date, formatted as YYYY-MM-DD in UTC. required: false schema: type: string - name: DateCreated< in: query description: >- Only return media created before this date, formatted as YYYY-MM-DD in UTC. required: false schema: type: string - name: DateCreated> in: query description: >- Only return media created after this date, formatted as YYYY-MM-DD in UTC. required: false schema: type: string - name: Page in: query description: The page number to retrieve. Default is 0. required: false schema: type: integer default: 0 - name: PageSize in: query description: The number of items per page. Default is 50, maximum is 1000. required: false schema: type: integer default: 50 - name: PageToken in: query description: The token for cursor-based pagination. Must start with 'PA' or 'PB'. required: false schema: type: string responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/MessageMediaListResponse' '400': description: >- The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '422': description: >- The request could not be processed due to validation errors. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' servers: - url: https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01 description: SignalWire Compatibility API components: schemas: uuid: type: string format: uuid description: Universal Unique Identifier. title: uuid MessageMedia: type: object properties: account_sid: $ref: '#/components/schemas/uuid' description: The unique identifier for the account. content_type: type: string description: The content type of the media. date_created: type: string description: The date, in RFC 2822 GMT format, this media was created. date_updated: type: string description: The date, in RFC 2822 GMT format, this media was updated. parent_sid: $ref: '#/components/schemas/uuid' description: The unique identifier for the message. sid: $ref: '#/components/schemas/uuid' description: The unique identifier for the media. uri: type: string description: The URI for the media. required: - account_sid - content_type - date_created - date_updated - parent_sid - sid - uri description: Message media model. title: MessageMedia MessageMediaListResponse: type: object properties: uri: type: string description: The URI of the current page. first_page_uri: type: string description: The URI of the first page. next_page_uri: type: - string - 'null' description: The URI of the next page, or null if there are no more pages. previous_page_uri: type: - string - 'null' description: The URI of the previous page, or null if this is the first page. page: type: integer description: The current page number. page_size: type: integer description: The number of items per page. media_list: type: array items: $ref: '#/components/schemas/MessageMedia' description: List of media. required: - uri - first_page_uri - next_page_uri - previous_page_uri - page - page_size - media_list description: Response containing a list of message media. title: MessageMediaListResponse CompatibilityErrorResponse: type: object properties: code: type: integer description: Error code. message: type: string description: Error message. more_info: type: string description: URL for more information about the error. status: type: integer description: HTTP status code. required: - code - message - more_info - status description: Error response model. title: CompatibilityErrorResponse ``` ## **Response Example** ### Response (200) ```json { "uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media?Page=0&PageSize=50", "first_page_uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media?Page=0&PageSize=50", "next_page_uri": null, "previous_page_uri": null, "page": 0, "page_size": 50, "media_list": [ { "account_sid": "ea108133-d6b3-407c-9536-9fad8a929a6a", "content_type": "image/jpeg", "date_created": "Mon, 13 Aug 2018 21:38:46 +0000", "date_updated": "Mon, 13 Aug 2018 21:38:46 +0000", "parent_sid": "0a059168-ead0-41af-9d1f-343dae832527", "sid": "b3877c40-da60-4998-90ad-b792e98472me", "uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media/b3877c40-da60-4998-90ad-b792e98472me.json" } ] } ``` ## **Example** ```typescript {8} import { RestClient } from "@signalwire/sdk"; const client = new RestClient({ project: "your-project-id", token: "your-api-token", host: "your-space.signalwire.com", }); const media = await client.compat.messages.listMedia("SM..."); ```