> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gridshare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get

Returns the metadata for a dynamic tariff together with a single page
of timeseries values.

The page covers a 7 day window. If `interval` is provided, the response
starts from the latest 7 days inside that interval and `nextToken`
paginates backwards 7 days at a time until `interval.start` is reached.

If `interval` is omitted the page covers the previous 7 days and
`nextToken` paginates backwards through the available history.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "version": "v1.0",
    "title": "Gridshare Partner API",
    "contact": {
      "name": "Lunar Energy",
      "url": "https://www.lunarenergy.com/gridshare",
      "email": "business@lunarenergy.com"
    }
  },
  "servers": [
    {
      "url": "https://developer-api.partner.mygridshare.com",
      "description": "Production server"
    },
    {
      "url": "https://developer-api.partner.dev0.mygridshare.com",
      "description": "Development server"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "headers": [
      {
        "key": "Authorization",
        "value": "Bearer ${AccessToken}"
      }
    ]
  },
  "paths": {
    "/api/v1/dynamicTariffs/{tariffId}": {
      "get": {
        "summary": "Get",
        "tags": [
          "Dynamic Tariff"
        ],
        "description": "Returns the metadata for a dynamic tariff together with a single page\nof timeseries values.\n\nThe page covers a 7 day window. If `interval` is provided, the response\nstarts from the latest 7 days inside that interval and `nextToken`\npaginates backwards 7 days at a time until `interval.start` is reached.\n\nIf `interval` is omitted the page covers the previous 7 days and\n`nextToken` paginates backwards through the available history.\n",
        "parameters": [
          {
            "description": "The unique identifier of the dynamic tariff.",
            "in": "path",
            "name": "tariffId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ISO 8601 interval (e.g. `2024-01-01T00:00Z/2024-01-08T00:00Z`). Optional. If omitted, returns the most recent 7 days.",
            "in": "query",
            "name": "interval",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Pagination token returned by a prior call. Mutually exclusive with `interval`; if both are provided, the token takes precedence.",
            "in": "query",
            "name": "nextToken",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "A single page of dynamic tariff data, including its metadata and a window of timeseries values.",
                  "allOf": [
                    {
                      "allOf": [
                        {
                          "$ref": "#/paths/~1api~1v1~1dynamicTariffs/post/requestBody/content/application~1json/schema/allOf/0"
                        },
                        {
                          "type": "object",
                          "required": [
                            "tariffId"
                          ],
                          "properties": {
                            "tariffId": {
                              "type": "string",
                              "description": "The unique identifier of the dynamic tariff.",
                              "example": "AcmeCorp::Zap-1--UUID1"
                            }
                          }
                        }
                      ]
                    },
                    {
                      "$ref": "#/paths/~1api~1v1~1dynamicTariffs~1%7BtariffId%7D/patch/requestBody/content/application~1json/schema"
                    },
                    {
                      "type": "object",
                      "required": [
                        "interval",
                        "nextToken"
                      ],
                      "properties": {
                        "interval": {
                          "type": "string",
                          "format": "interval",
                          "description": "The ISO 8601 interval covered by this page.",
                          "example": "2024-01-01T00:00Z/2024-01-02T00:00Z"
                        },
                        "nextToken": {
                          "description": "Opaque pagination token. Pass to the next call to retrieve the previous 7 days. `null` when there are no more pages.",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "description": "200 response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1api~1v1~1sites/get/responses/401/content/application~1json/schema"
                }
              }
            },
            "description": "401 response"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1api~1v1~1sites/get/responses/404/content/application~1json/schema"
                }
              }
            },
            "description": "404 response"
          }
        }
      }
    }
  }
}
```