{
  "info": {
    "_postman_id": "ba29cf43-9851-434c-9418-b3fc90ce944d",
    "name": "USDA AMS MARS API (MyMarketNews) Offices Reports API",
    "description": "The Market Analysis Reporting System (MARS) API provides programmatic access to USDA Agricultural Marketing Service agricultural market news data. The API allows users to automatically pull raw market news data including commodity prices, volume, and trade reports across livestock, dairy, fruits, vegetables, grains, and other agricultural commodities. Authentication via Basic auth with an API key is supported for registered users; no key is required for public access. All responses are in JSON format.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T00:29:05.000Z",
    "updatedAt": "2026-07-28T00:29:06.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-ba29cf43-9851-434c-9418-b3fc90ce944d"
  },
  "item": [
    {
      "name": "reports",
      "item": [
        {
          "name": "{slug_id}",
          "item": [
            {
              "name": "USDA AMS Get Report",
              "id": "4ec61d01-6802-4618-838a-d9e45f77b5d1",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/:slug_id?startDate=<date>&endDate=<date>&limit=<integer>&offset=<integer>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    ":slug_id"
                  ],
                  "query": [
                    {
                      "description": "Start date for filtering data within the report (YYYY-MM-DD).",
                      "key": "startDate",
                      "value": "<date>"
                    },
                    {
                      "description": "End date for filtering data (YYYY-MM-DD). Maximum 180 days from startDate.",
                      "key": "endDate",
                      "value": "<date>"
                    },
                    {
                      "description": "Maximum records to return.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Number of records to skip.",
                      "key": "offset",
                      "value": "<integer>"
                    }
                  ],
                  "variable": [
                    {
                      "id": "9510b8c9-3acf-4410-a01a-cd6c5856e060",
                      "key": "slug_id",
                      "value": "<string>",
                      "description": "(Required) Unique identifier (Slug_ID) for the market news report."
                    }
                  ]
                },
                "description": "Returns market news data for a specific report identified by its unique slug_id. Returns the full report data including commodity prices, volumes, and trade information."
              },
              "response": [
                {
                  "id": "0c78035d-cf3f-4938-9536-aa1a8bab95fb",
                  "name": "Report data with commodity prices and market information.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/:slug_id?startDate=<date>&endDate=<date>&limit=<integer>&offset=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        ":slug_id"
                      ],
                      "query": [
                        {
                          "description": "Start date for filtering data within the report (YYYY-MM-DD).",
                          "key": "startDate",
                          "value": "<date>"
                        },
                        {
                          "description": "End date for filtering data (YYYY-MM-DD). Maximum 180 days from startDate.",
                          "key": "endDate",
                          "value": "<date>"
                        },
                        {
                          "description": "Maximum records to return.",
                          "key": "limit",
                          "value": "<integer>"
                        },
                        {
                          "description": "Number of records to skip.",
                          "key": "offset",
                          "value": "<integer>"
                        }
                      ],
                      "variable": [
                        {
                          "key": "slug_id"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"results\": [\n    {\n      \"slug_id\": \"<string>\",\n      \"slug_name\": \"<string>\",\n      \"report_date\": \"<date>\",\n      \"published_date\": \"<dateTime>\",\n      \"commodity\": \"<string>\",\n      \"class\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"head_count\": \"<integer>\",\n      \"price_per_cwt\": \"<double>\",\n      \"price_unit\": \"<string>\",\n      \"region\": \"<string>\"\n    },\n    {\n      \"slug_id\": \"<string>\",\n      \"slug_name\": \"<string>\",\n      \"report_date\": \"<date>\",\n      \"published_date\": \"<dateTime>\",\n      \"commodity\": \"<string>\",\n      \"class\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"head_count\": \"<integer>\",\n      \"price_per_cwt\": \"<double>\",\n      \"price_unit\": \"<string>\",\n      \"region\": \"<string>\"\n    }\n  ],\n  \"stats\": {\n    \"count\": \"<integer>\",\n    \"total\": \"<integer>\"\n  }\n}",
                  "createdAt": "2026-07-28T00:29:06.000Z",
                  "updatedAt": "2026-07-28T00:29:06.000Z",
                  "uid": "35240-0c78035d-cf3f-4938-9536-aa1a8bab95fb"
                },
                {
                  "id": "1792af7b-537c-4eed-a5ca-6daa25bc896e",
                  "name": "Report not found.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/:slug_id?startDate=<date>&endDate=<date>&limit=<integer>&offset=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        ":slug_id"
                      ],
                      "query": [
                        {
                          "description": "Start date for filtering data within the report (YYYY-MM-DD).",
                          "key": "startDate",
                          "value": "<date>"
                        },
                        {
                          "description": "End date for filtering data (YYYY-MM-DD). Maximum 180 days from startDate.",
                          "key": "endDate",
                          "value": "<date>"
                        },
                        {
                          "description": "Maximum records to return.",
                          "key": "limit",
                          "value": "<integer>"
                        },
                        {
                          "description": "Number of records to skip.",
                          "key": "offset",
                          "value": "<integer>"
                        }
                      ],
                      "variable": [
                        {
                          "key": "slug_id"
                        }
                      ]
                    }
                  },
                  "status": "Not Found",
                  "code": 404,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": \"<string>\",\n  \"message\": \"<string>\",\n  \"status\": \"<integer>\"\n}",
                  "createdAt": "2026-07-28T00:29:06.000Z",
                  "updatedAt": "2026-07-28T00:29:06.000Z",
                  "uid": "35240-1792af7b-537c-4eed-a5ca-6daa25bc896e"
                }
              ],
              "createdAt": "2026-07-28T00:29:06.000Z",
              "updatedAt": "2026-07-28T00:29:06.000Z",
              "uid": "35240-4ec61d01-6802-4618-838a-d9e45f77b5d1"
            }
          ],
          "id": "7daf83c5-e28c-4df7-a835-2cc25c004591",
          "createdAt": "2026-07-28T00:29:06.000Z",
          "updatedAt": "2026-07-28T00:29:06.000Z",
          "uid": "35240-7daf83c5-e28c-4df7-a835-2cc25c004591"
        },
        {
          "name": "USDA AMS List Reports",
          "id": "a0c2e860-8c4f-4539-959c-b81420267fbf",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/reports?q=<string>&allSections=<boolean>&dateType=published&startDate=<date>&endDate=<date>&slug_id=<string>&class=<string>&limit=<integer>&offset=<integer>&sort_by=<string>&sort_order=asc",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reports"
              ],
              "query": [
                {
                  "description": "Search query to filter reports by name or description.",
                  "key": "q",
                  "value": "<string>"
                },
                {
                  "description": "Return all report sections (true/false).",
                  "key": "allSections",
                  "value": "<boolean>"
                },
                {
                  "description": "Date type to filter by (published, report).",
                  "key": "dateType",
                  "value": "published"
                },
                {
                  "description": "Start date for filtering reports (YYYY-MM-DD).",
                  "key": "startDate",
                  "value": "<date>"
                },
                {
                  "description": "End date for filtering reports (YYYY-MM-DD). Maximum 180 days from startDate.",
                  "key": "endDate",
                  "value": "<date>"
                },
                {
                  "description": "Filter by specific report slug ID.",
                  "key": "slug_id",
                  "value": "<string>"
                },
                {
                  "description": "Filter by commodity class (e.g., Livestock, Dairy, Fruit/Veg).",
                  "key": "class",
                  "value": "<string>"
                },
                {
                  "description": "Maximum number of records to return (max 100000).",
                  "key": "limit",
                  "value": "<integer>"
                },
                {
                  "description": "Number of records to skip for pagination.",
                  "key": "offset",
                  "value": "<integer>"
                },
                {
                  "description": "Field to sort results by.",
                  "key": "sort_by",
                  "value": "<string>"
                },
                {
                  "description": "Sort order (asc or desc).",
                  "key": "sort_order",
                  "value": "asc"
                }
              ]
            },
            "description": "Returns a list of all available market news reports. Each report has a unique Slug_ID and Slug_Name that serve as identifiers. Reports cover livestock, dairy, fruits, vegetables, grains, cotton, tobacco, poultry, and other agricultural commodities."
          },
          "response": [
            {
              "id": "b2ca732c-f8d9-43ef-930e-68defcd0c676",
              "name": "A list of market news reports.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports?q=<string>&allSections=<boolean>&dateType=published&startDate=<date>&endDate=<date>&slug_id=<string>&class=<string>&limit=<integer>&offset=<integer>&sort_by=<string>&sort_order=asc",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports"
                  ],
                  "query": [
                    {
                      "description": "Search query to filter reports by name or description.",
                      "key": "q",
                      "value": "<string>"
                    },
                    {
                      "description": "Return all report sections (true/false).",
                      "key": "allSections",
                      "value": "<boolean>"
                    },
                    {
                      "description": "Date type to filter by (published, report).",
                      "key": "dateType",
                      "value": "published"
                    },
                    {
                      "description": "Start date for filtering reports (YYYY-MM-DD).",
                      "key": "startDate",
                      "value": "<date>"
                    },
                    {
                      "description": "End date for filtering reports (YYYY-MM-DD). Maximum 180 days from startDate.",
                      "key": "endDate",
                      "value": "<date>"
                    },
                    {
                      "description": "Filter by specific report slug ID.",
                      "key": "slug_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filter by commodity class (e.g., Livestock, Dairy, Fruit/Veg).",
                      "key": "class",
                      "value": "<string>"
                    },
                    {
                      "description": "Maximum number of records to return (max 100000).",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Number of records to skip for pagination.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "Field to sort results by.",
                      "key": "sort_by",
                      "value": "<string>"
                    },
                    {
                      "description": "Sort order (asc or desc).",
                      "key": "sort_order",
                      "value": "asc"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"results\": [\n    {\n      \"slug_id\": \"<string>\",\n      \"slug_name\": \"<string>\",\n      \"report_date\": \"<date>\",\n      \"published_date\": \"<dateTime>\",\n      \"commodity\": \"<string>\",\n      \"market_type\": \"<string>\",\n      \"office\": \"<string>\",\n      \"section_name\": \"<string>\"\n    },\n    {\n      \"slug_id\": \"<string>\",\n      \"slug_name\": \"<string>\",\n      \"report_date\": \"<date>\",\n      \"published_date\": \"<dateTime>\",\n      \"commodity\": \"<string>\",\n      \"market_type\": \"<string>\",\n      \"office\": \"<string>\",\n      \"section_name\": \"<string>\"\n    }\n  ],\n  \"stats\": {\n    \"count\": \"<integer>\",\n    \"total\": \"<integer>\"\n  }\n}",
              "createdAt": "2026-07-28T00:29:06.000Z",
              "updatedAt": "2026-07-28T00:29:06.000Z",
              "uid": "35240-b2ca732c-f8d9-43ef-930e-68defcd0c676"
            },
            {
              "id": "5e02494c-bbdc-4512-b707-02c97d3cb28d",
              "name": "Bad request. Invalid query parameters.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports?q=<string>&allSections=<boolean>&dateType=published&startDate=<date>&endDate=<date>&slug_id=<string>&class=<string>&limit=<integer>&offset=<integer>&sort_by=<string>&sort_order=asc",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports"
                  ],
                  "query": [
                    {
                      "description": "Search query to filter reports by name or description.",
                      "key": "q",
                      "value": "<string>"
                    },
                    {
                      "description": "Return all report sections (true/false).",
                      "key": "allSections",
                      "value": "<boolean>"
                    },
                    {
                      "description": "Date type to filter by (published, report).",
                      "key": "dateType",
                      "value": "published"
                    },
                    {
                      "description": "Start date for filtering reports (YYYY-MM-DD).",
                      "key": "startDate",
                      "value": "<date>"
                    },
                    {
                      "description": "End date for filtering reports (YYYY-MM-DD). Maximum 180 days from startDate.",
                      "key": "endDate",
                      "value": "<date>"
                    },
                    {
                      "description": "Filter by specific report slug ID.",
                      "key": "slug_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filter by commodity class (e.g., Livestock, Dairy, Fruit/Veg).",
                      "key": "class",
                      "value": "<string>"
                    },
                    {
                      "description": "Maximum number of records to return (max 100000).",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Number of records to skip for pagination.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "Field to sort results by.",
                      "key": "sort_by",
                      "value": "<string>"
                    },
                    {
                      "description": "Sort order (asc or desc).",
                      "key": "sort_order",
                      "value": "asc"
                    }
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"error\": \"<string>\",\n  \"message\": \"<string>\",\n  \"status\": \"<integer>\"\n}",
              "createdAt": "2026-07-28T00:29:06.000Z",
              "updatedAt": "2026-07-28T00:29:06.000Z",
              "uid": "35240-5e02494c-bbdc-4512-b707-02c97d3cb28d"
            },
            {
              "id": "79a2aed7-e841-4f91-b62b-9b87fc47f117",
              "name": "Unauthorized. Invalid API key.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports?q=<string>&allSections=<boolean>&dateType=published&startDate=<date>&endDate=<date>&slug_id=<string>&class=<string>&limit=<integer>&offset=<integer>&sort_by=<string>&sort_order=asc",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports"
                  ],
                  "query": [
                    {
                      "description": "Search query to filter reports by name or description.",
                      "key": "q",
                      "value": "<string>"
                    },
                    {
                      "description": "Return all report sections (true/false).",
                      "key": "allSections",
                      "value": "<boolean>"
                    },
                    {
                      "description": "Date type to filter by (published, report).",
                      "key": "dateType",
                      "value": "published"
                    },
                    {
                      "description": "Start date for filtering reports (YYYY-MM-DD).",
                      "key": "startDate",
                      "value": "<date>"
                    },
                    {
                      "description": "End date for filtering reports (YYYY-MM-DD). Maximum 180 days from startDate.",
                      "key": "endDate",
                      "value": "<date>"
                    },
                    {
                      "description": "Filter by specific report slug ID.",
                      "key": "slug_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filter by commodity class (e.g., Livestock, Dairy, Fruit/Veg).",
                      "key": "class",
                      "value": "<string>"
                    },
                    {
                      "description": "Maximum number of records to return (max 100000).",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Number of records to skip for pagination.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "Field to sort results by.",
                      "key": "sort_by",
                      "value": "<string>"
                    },
                    {
                      "description": "Sort order (asc or desc).",
                      "key": "sort_order",
                      "value": "asc"
                    }
                  ]
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"error\": \"<string>\",\n  \"message\": \"<string>\",\n  \"status\": \"<integer>\"\n}",
              "createdAt": "2026-07-28T00:29:06.000Z",
              "updatedAt": "2026-07-28T00:29:06.000Z",
              "uid": "35240-79a2aed7-e841-4f91-b62b-9b87fc47f117"
            }
          ],
          "createdAt": "2026-07-28T00:29:06.000Z",
          "updatedAt": "2026-07-28T00:29:06.000Z",
          "uid": "35240-a0c2e860-8c4f-4539-959c-b81420267fbf"
        }
      ],
      "id": "a8a88c98-5c14-49a4-ac37-19f447ecb653",
      "createdAt": "2026-07-28T00:29:06.000Z",
      "updatedAt": "2026-07-28T00:29:06.000Z",
      "uid": "35240-a8a88c98-5c14-49a4-ac37-19f447ecb653"
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://marsapi.ams.usda.gov/services/v1.2"
    }
  ]
}