# Get market timeline

GET /api/v1/markets/{market\_address}/timeline

## Get market timeline

> Returns the full lifecycle event history for the question backing this market — including when it was launched, extended, resolved, and finalised — with timestamps and winning outcomes for each event.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/markets/{market_address}/timeline","name":"get-market-timeline"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/markets/{market_address}/timeline":{"get":{"description":"Returns the full lifecycle event history for the question backing this market — including when it was launched, extended, resolved, and finalised — with timestamps and winning outcomes for each event.","tags":["get-market-timeline"],"summary":"Get market timeline","parameters":[{"schema":{"type":"string"},"description":"Market contract address","name":"market_address","in":"path","required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.TimelineResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"handler.TimelineResponse":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/handler.TimelineEvent"}}}},"handler.TimelineEvent":{"type":"object","properties":{"answer":{"type":"integer"},"newEndTimestamp":{"type":"integer"},"timestamp":{"type":"integer"},"type":{"type":"string"},"winningOutcomes":{"type":"array","items":{"$ref":"#/components/schemas/handler.WinningOutcomeItem"}}}},"handler.WinningOutcomeItem":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```
