# Dynamic Thema scores

## Dynamic Thema rankings.

> This returns the latest dynamic thema rankings for editions which have dynamic thema scores enabled.

```json
{"openapi":"3.0.3","info":{"title":"Grand Archive API","version":"1.1.0"},"servers":[{"url":"https://api.gatcg.com","description":"Production server (uses live data)"}],"paths":{"/cards/edition/dynamic-thema-ranks":{"get":{"operationId":"GetEditionsWithRankedDynamicThemaScoresAPISpec_get_/edition/dynamic-thema-ranks","tags":["Thema scores"],"summary":"Dynamic Thema rankings.","description":"This returns the latest dynamic thema rankings for editions which have dynamic thema scores enabled.","parameters":[{"description":"A 10-character alphanumeric UUID.","name":"uuid","in":"query","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["FOIL","NONFOIL"],"type":"string"}}],"responses":{"200":{"description":"A list of ranked dynamic thema score editions.","content":{"application/json":{"schema":{"description":"A list of ranked dynamic thema score editions.","type":"array","items":{"type":"object","properties":{"score":{"$ref":"#/components/schemas/Omit_EditionThemaRanked__kind___uuid___created_at__"},"kind":{"$ref":"#/components/schemas/CirculationKind"},"classes":{"description":"The card's classes. The possible values are revealed by the `option/search` endpoint.","type":"array","items":{"type":"string"}},"cost":{"description":"The card's cost.","type":"object","properties":{"type":{"description":"The cost type.","enum":["memory","none","reserve"],"type":"string"},"value":{"description":"The cost value.\nThis is a number represented as a string, or a dynamic cost like `\"X\"`.\nThis is only `null` if the cost type is `\"none\"`.","type":"string","nullable":true}},"additionalProperties":false,"required":["type","value"]},"cost_memory":{"$ref":"#/components/schemas/CardCostMemory"},"cost_reserve":{"$ref":"#/components/schemas/CardCostReserve"},"created_at":{"type":"string","format":"date-time"},"durability":{"$ref":"#/components/schemas/CardStatDurability"},"effect":{"$ref":"#/components/schemas/CardEffectTemplate"},"effect_raw":{"$ref":"#/components/schemas/CardEffectRaw"},"element":{"type":"string"},"elements":{"type":"array","items":{"type":"string"}},"flavor":{"$ref":"#/components/schemas/CardFlavor"},"last_update":{"type":"string","format":"date-time"},"level":{"$ref":"#/components/schemas/CardStatLevel"},"life":{"$ref":"#/components/schemas/CardStatLife"},"name":{"type":"string"},"power":{"$ref":"#/components/schemas/CardStatPower"},"slug":{"type":"string"},"speed":{"$ref":"#/components/schemas/CardStatSpeed"},"subtypes":{"description":"The card's subtypes. The possible values are revealed by the `option/search` endpoint.","type":"array","items":{"type":"string"}},"types":{"description":"The card's types. The possible values are revealed by the `option/search` endpoint.","type":"array","items":{"type":"string"}},"uuid":{"type":"string"},"edition":{"type":"object","properties":{"card_id":{"type":"string"},"collaborators":{"type":"array","items":{"type":"string"}},"collector_number":{"type":"string"},"configuration":{"$ref":"#/components/schemas/EditionConfiguration"},"created_at":{"type":"string","format":"date-time"},"effect":{"$ref":"#/components/schemas/EditionEffect"},"effect_raw":{"$ref":"#/components/schemas/EditionEffectRaw"},"flavor":{"$ref":"#/components/schemas/EditionFlavor"},"illustrator":{"$ref":"#/components/schemas/EditionIllustrator"},"image":{"type":"string"},"last_update":{"type":"string","format":"date-time"},"orientation":{"$ref":"#/components/schemas/EditionOrientation"},"rarity":{"type":"number"},"set":{"type":"object","properties":{"created_at":{"description":"When the dataset was created.","type":"string","format":"date-time"},"id":{"description":"A 10-character alphanumeric UUID.","type":"string"},"language":{"description":"The language used by the dataset.","type":"string"},"last_update":{"description":"When the dataset was last updated.","type":"string","format":"date-time"},"name":{"description":"The name of the set.","type":"string"},"prefix":{"description":"The set's prefix as printed in the footer of its cards.","type":"string"},"release_date":{"description":"When the set was publicly-released.","type":"string","format":"date-time"}},"additionalProperties":false,"required":["created_at","id","language","last_update","name","prefix","release_date"]},"slug":{"type":"string"},"thema_foil_dynamic":{"type":"boolean"},"thema_nonfoil_dynamic":{"type":"boolean"},"uuid":{"type":"string"}},"additionalProperties":false,"required":["card_id","collaborators","collector_number","configuration","created_at","effect","effect_raw","flavor","illustrator","image","last_update","orientation","rarity","set","slug","thema_foil_dynamic","thema_nonfoil_dynamic","uuid"]}},"additionalProperties":false,"required":["classes","cost","cost_memory","cost_reserve","created_at","durability","edition","effect","effect_raw","element","elements","flavor","kind","last_update","level","life","name","power","score","slug","speed","subtypes","types","uuid"]}}}}},"400":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"description":"Error message.","type":"string"}},"additionalProperties":false,"required":["error"]}}}}}}}},"components":{"schemas":{"Omit_EditionThemaRanked__kind___uuid___created_at__":{"type":"object","properties":{"change":{"description":"The percent change in the edition's total thema score compared to its previous total thema score in the dataset.\nA positive number represents an increase in total thema score, whilst a negative number represents a decrease in total thema score.","type":"number"},"thema_total":{"$ref":"#/components/schemas/EditionThemaScoreTotal"},"thema_charm":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_ferocity":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_grace":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_mystique":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_valor":{"$ref":"#/components/schemas/EditionThemaScore"},"rank":{"description":"The overall rank of the edition's total thema scores on the given created at date in relation to other editions with dynamic thema scores.","type":"number"},"rank_change":{"description":"The change in the edition's overall rank compared to its previous rank in the dataset.\nA positive number represents a rise in rank, whilst a negative number represents a fall in rank.","type":"number"}},"additionalProperties":false,"required":["change","rank","rank_change","thema_charm","thema_ferocity","thema_grace","thema_mystique","thema_total","thema_valor"]},"EditionThemaScoreTotal":{"description":"The sum of a range of edition Thema score values.","type":"number","nullable":true},"EditionThemaScore":{"description":"One of the edition's Thema score values.","type":"number","nullable":true},"CirculationKind":{"enum":["FOIL","NONFOIL"],"type":"string"},"CardCostMemory":{"description":"The card's memory cost (`cost_reserve` will be `null` if this is numeric).\nBe aware that cards can have both memory and reserve cost set to `null` (example: Shifting Currents).","minimum":0,"type":"number","nullable":true,"deprecated":true},"CardCostReserve":{"description":"The card's reserve cost (`cost_memory` will be `null` if this is numeric).\n`-1` represents a card with \"X\" cost (example: Lost in Thought).\nBe aware that cards can have both memory and reserve cost set to `null` (example: Shifting Currents).","minimum":-1,"type":"number","nullable":true,"deprecated":true},"CardStatDurability":{"description":"The card's durability stat.","type":"number","nullable":true},"CardEffectTemplate":{"description":"The card's effect as a template.","type":"string","nullable":true},"CardEffectRaw":{"description":"The card's effect as plain text. This is `null` if the card's `effect` value is `null`.","type":"string","nullable":true},"CardFlavor":{"description":"The card's flavor text.","type":"string","nullable":true},"CardStatLevel":{"description":"The card's level stat.","type":"number","nullable":true},"CardStatLife":{"description":"The card's life stat.","type":"number","nullable":true},"CardStatPower":{"description":"The card's power stat.","type":"number","nullable":true},"CardStatSpeed":{"description":"The card's speed stat. `true` represents Fast whilst `false` represents Slow.","type":"boolean","nullable":true},"EditionConfiguration":{"description":"The edition's play configuration. The `\"flip\"` response is given on editions which are double-faced.","enum":["default","flip"],"type":"string"},"EditionEffect":{"description":"The edition's specific effect. This is only populated if the value differs from the parent `Card`'s `effect` value.","type":"string","nullable":true},"EditionEffectRaw":{"description":"The edition's specific raw effect. This is `null` if the edition's `effect` value is `null`.","type":"string","nullable":true},"EditionFlavor":{"description":"The edition's specific flavor text. This is only populated if the value differs from the parent `Card`'s `flavor` value.","type":"string","nullable":true},"EditionIllustrator":{"description":"The edition's illustrator.","type":"string","nullable":true},"EditionOrientation":{"description":"The edition's orientation. This is set to `\"front\"` or `\"back\"` if the edition's `configuration` is `\"flip\"`, otherwise it will be `null`.","anyOf":[{"enum":["back","front"],"type":"string"}],"nullable":true}}}}
```

## Dynamic Thema history.

> This returns up to 1 year worth of dynamic thema score history for a given edition and circulation kind.

```json
{"openapi":"3.0.3","info":{"title":"Grand Archive API","version":"1.1.0"},"servers":[{"url":"https://api.gatcg.com","description":"Production server (uses live data)"}],"paths":{"/cards/edition/{edition_uuid}/dynamic-thema":{"get":{"operationId":"GetEditionDynamicThemaHistoryAPISpec_get_/edition/{edition_uuid}/dynamic-thema","tags":["Thema scores"],"summary":"Dynamic Thema history.","description":"This returns up to 1 year worth of dynamic thema score history for a given edition and circulation kind.","parameters":[{"description":"A 10-character alphanumeric UUID.","name":"edition_uuid","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CirculationKind"}},{"description":"The start date for the dynamic thema score history.\nIf provided alongside a `to` date, the range must be no greater than 1 year.\nIf no `to` date is provided, the `to` date will be defaulted to 1 year after the specified `from` date.\nDefaults to 1 year before the current date if not provided.","name":"from","in":"query","required":false,"schema":{"format":"date","type":"string"}},{"description":"The end date for the dynamic thema score history.\nIf provided alongside a `from` date, the range must be no greater than 1 year.\nIf no `from` date is provided, the `from` date will be defaulted to 1 year before the specified `to` date.\nDefaults to the current date if not provided.","name":"to","in":"query","required":false,"schema":{"format":"date","type":"string"}}],"responses":{"200":{"description":"A list of dynamic thema score history for the specified edition and circulation kind.","content":{"application/json":{"schema":{"description":"A list of dynamic thema score history for the specified edition and circulation kind.","type":"array","items":{"type":"object","properties":{"uuid":{"description":"A 10-character alphanumeric UUID.","type":"string"},"kind":{"$ref":"#/components/schemas/CirculationKind"},"thema_total":{"$ref":"#/components/schemas/EditionThemaScoreTotal"},"thema_charm":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_ferocity":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_grace":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_mystique":{"$ref":"#/components/schemas/EditionThemaScore"},"thema_valor":{"$ref":"#/components/schemas/EditionThemaScore"},"created_at":{"description":"When the dataset was created.","type":"string","format":"date-time"},"rank":{"description":"The overall rank of the edition's total thema scores on the given created at date in relation to other editions with dynamic thema scores.","type":"number"},"rank_change":{"description":"The change in the edition's overall rank compared to its previous rank in the dataset.\nA positive number represents a rise in rank, whilst a negative number represents a fall in rank.","type":"number"},"change":{"description":"The percent change in the edition's total thema score compared to its previous total thema score in the dataset.\nA positive number represents an increase in total thema score, whilst a negative number represents a decrease in total thema score.","type":"number"}},"additionalProperties":false,"required":["change","created_at","kind","rank","rank_change","thema_charm","thema_ferocity","thema_grace","thema_mystique","thema_total","thema_valor","uuid"]}}}}},"400":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"description":"Error message.","type":"string"}},"additionalProperties":false,"required":["error"]}}}}}}}},"components":{"schemas":{"CirculationKind":{"enum":["FOIL","NONFOIL"],"type":"string"},"EditionThemaScoreTotal":{"description":"The sum of a range of edition Thema score values.","type":"number","nullable":true},"EditionThemaScore":{"description":"One of the edition's Thema score values.","type":"number","nullable":true}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.gatcg.com/endpoints/dynamic-thema-scores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.