---
title: "Source"
description: "anywhere the market is read, with its rights and its role"
section: concepts
address: /concepts/source
contract: 0476e35e6e275db5
---

# Source

anywhere the market is read, with its rights and its role

[figure: Source is a row at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | row |
| scope | platform |
| key | its name |
| store | postgres |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes |  |
| `market` | `text` | yes |  |
| `jurisdiction` | `text` | yes |  |
| `rights` | [Rights](/concepts/rights) | yes |  |
| `role` | `one of owns the record \| a copy of another platform's reading \| a one-off catch-up \| derived from other sources \| a tenant's own \| an extract with no chain of custody` | yes |  |
| `copy_of` | [Source](/concepts/source) | no |  |
| `legality_tier` | `one of 1 \| 2 \| 3 \| not allowed \| unknown` | yes | unknown makes the source not ready with the reason |
| `basis_of_times` | `one of published \| scheduled \| first seen \| captured \| imported \| retrieved` | yes | captured is when the source or an exporter took the reading, imported when it entered the system that held it, retrieved when it was fetched from that system |
| `state` | [Readiness](/concepts/readiness) | yes |  |
| `forced_open_by` | `text` | no | the law or rule that forces the source to publish, where one does; a register a regulator keeps names it |



## Routes that use it
No route takes or returns Source directly. The record holds it, and the objects that point at it reach it.