> ## Documentation Index > Fetch the complete documentation index at: https://developers.momogood.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve All Scheduled Messages in a List > This endpoint retrieves all scheduled messages in a list. ## Request URL ```http theme={null} GET https://app.tatango.com/api/v2/lists/{ID}/messages/scheduled ``` ## OpenAPI ````yaml GET /api/v2/lists/{ID}/messages/scheduled openapi: 3.1.0 info: title: momoGood Messaging API v2 description: >- The platform management API for momoGood Messaging (formerly the Tatango v2 API). Manage lists, subscribers, custom fields, tags, webhooks, shortcodes, MOMT reports, and scheduled broadcasts from a single REST surface. version: 2.0.0 servers: - url: https://app.tatango.com security: - basicAuth: [] paths: /api/v2/lists/{ID}/messages/scheduled: get: tags: - Messaging summary: Retrieve All Scheduled Messages in a List description: This endpoint retrieves all scheduled messages in a list. parameters: - name: ID in: path description: The ID of the list required: true schema: type: integer - name: start_date in: query description: >- A date in YYYYMMDD format. Scheduled messages scheduled to send before this date will not be returned (UTC). required: false schema: type: string pattern: ^[0-9]{8}$ - name: end_date in: query description: >- A date in YYYYMMDD format. Scheduled messages scheduled to send after this date will not be returned (UTC). required: false schema: type: string pattern: ^[0-9]{8}$ responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/RetrieveAllScheduledMessagesResponse' example: status: OK per_page: 10 count: 2 page: 1 pages_count: 1 messages: - id: 14523 content: >- AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end. sent_at: '2016-09-07T14:10:53-07:00' status: scheduled name: my message name is_broadcast: false recipient_count: 0 success_count: 0 bounces_count: 0 pending_count: 0 clean_count: 0 unsubscribe_count: 0 sms_count: 0 mms_count: 0 rcs_count: 0 send_cost: 0 attachment: https://url-to-your-mms-attachment x-codeSamples: - lang: cURL label: cURL source: >- curl "https://app.tatango.com/api/v2/lists//messages/scheduled" -d '{"start_date":"20160901", "end_date":"20161030"}' -X GET \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u emailaddress@mydomain.com:my_api_key \ -H "Host: example.org" \ -H "Cookie: " - lang: Ruby label: Ruby source: >- require 'net/http' require 'uri' uri = URI.parse('https://app.tatango.com/api/v2/lists//messages/scheduled') http = Net::HTTP.new(uri.host, uri.port) request = Net::HTTP::Get.new(uri.request_url) request.basic_auth("emailaddress@mydomain.com", "my_api_key") request.body({"start_date":"20160901", "end_date":"20161030"}); response = http.request(request) - lang: JavaScript label: JavaScript source: >- var request = new XMLHttpRequest(); request.open( "GET", "https://app.tatango.com/api/v2/lists//messages/scheduled", false ); request.setRequestHeader("Content-Type", "application/json"); request.setRequestHeader( "Authorization", "Basic " + btoa("emailaddress@mydomain.com:my_api_key") ); var data = JSON.stringify({ start_date: "20160901", end_date: "20161030" }); request.send(data); components: schemas: RetrieveAllScheduledMessagesResponse: type: object properties: status: type: string example: OK per_page: type: integer description: Number of items per page example: 10 count: type: integer description: Number of messages returned example: 2 page: type: integer example: 1 description: Current page number pages_count: type: integer description: Total number of pages example: 1 messages: type: array items: type: object properties: id: type: integer description: Message ID example: 14523 content: type: string description: Message content example: >- AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end. status: type: string description: Message status example: scheduled sent_at: type: string format: date-time description: Timestamp when the message is scheduled to be sent example: '2016-09-07T14:10:53-07:00' name: type: string description: Message name example: my message name is_broadcast: type: boolean description: Whether this is a broadcast message example: false recipient_count: type: integer description: Number of recipients example: 0 success_count: type: integer description: Number of successful deliveries example: 0 bounces_count: type: integer description: Number of bounced messages example: 0 pending_count: type: integer description: Number of pending messages example: 0 clean_count: type: integer description: Number of cleaned messages example: 0 unsubscribe_count: type: integer description: Number of unsubscribes triggered by this message example: 0 sms_count: type: integer description: Number of SMS messages sent example: 0 mms_count: type: integer description: Number of MMS messages sent example: 0 rcs_count: type: integer description: Number of RCS messages sent example: 0 send_cost: type: number format: float description: Cost of sending the message example: 0 attachment: type: string description: URL to MMS attachment example: https://url-to-your-mms-attachment required: - id - content - status - sent_at - name - is_broadcast - recipient_count - success_count - bounces_count - pending_count - clean_count - unsubscribe_count - sms_count - mms_count - rcs_count - send_cost required: - status - per_page - count - page - pages_count - messages securitySchemes: basicAuth: type: http scheme: basic description: >- The momoGood Messaging API v2 authenticates requests by validating an API key passed via HTTP Basic Authentication. Use your login email as the username and your API key as the password. ````