> For the complete documentation index, see [llms.txt](https://docs.ama.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ama.one/http-api/epoch.md).

# Epoch

Epoch and validator scoring information

## Get epoch scores for all validators

> Retrieve mining scores for all validators in the current epoch

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Epoch","description":"Epoch and validator scoring information"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/epoch/score":{"get":{"tags":["Epoch"],"summary":"Get epoch scores for all validators","description":"Retrieve mining scores for all validators in the current epoch","responses":{"200":{"description":"Epoch scores","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get epoch score for validator

> Retrieve mining score for a specific validator

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Epoch","description":"Epoch and validator scoring information"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/epoch/score/{pk}":{"get":{"tags":["Epoch"],"summary":"Get epoch score for validator","description":"Retrieve mining score for a specific validator","parameters":[{"name":"pk","in":"path","required":true,"description":"Validator public key (Base58 encoded)","schema":{"type":"string"}}],"responses":{"200":{"description":"Validator epoch score","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get emission address for validator

> Retrieve the emission (reward) address for a validator

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Epoch","description":"Epoch and validator scoring information"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/epoch/get_emission_address/{pk}":{"get":{"tags":["Epoch"],"summary":"Get emission address for validator","description":"Retrieve the emission (reward) address for a validator","parameters":[{"name":"pk","in":"path","required":true,"description":"Validator public key (Base58 encoded)","schema":{"type":"string"}}],"responses":{"200":{"description":"Emission address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"emission_address":{"type":"string"}}}}}}}}}}}
```

## Check if solution is in epoch

> Verify if a specific proof-of-work solution was submitted in an epoch

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Epoch","description":"Epoch and validator scoring information"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/epoch/sol_in_epoch/{epoch}/{sol_hash}":{"get":{"tags":["Epoch"],"summary":"Check if solution is in epoch","description":"Verify if a specific proof-of-work solution was submitted in an epoch","parameters":[{"name":"epoch","in":"path","required":true,"description":"Epoch number","schema":{"type":"integer"}},{"name":"sol_hash","in":"path","required":true,"description":"Solution hash (Base58 encoded)","schema":{"type":"string"}}],"responses":{"200":{"description":"Solution verification result","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```