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

# Contributions

> Send values that are missing or wrong. They're stored for review and never change the catalog directly.

Someone holding a record can see what no dump has: the runout etching, the vinyl color, the barcode on a pressing that lacks one. `POST /v1/contributions` collects those.

* Submissions go into a **review queue**. They don't change the catalog.
* **No photos.** If your app takes a photo, extract the facts on the device and send those in `evidence`. Requests that include image data are rejected.
* Automatic **checks** run on every submission and are stored with it for the reviewer.

## Submit a value

```bash theme={null}
curl -X POST "https://api.openvinyl.dev/v1/contributions" \
  -H "content-type: application/json" \
  -d '{
    "target_kind": "pressing",
    "release_id": 383812,
    "field": "barcode",
    "value": "0 78636 80451 4",
    "submitter": "your-app-user-123",
    "client": "my-vinyl-app",
    "evidence": { "barcode_decoded": "078636804514", "decoded_on": "device" }
  }'
```

```json theme={null}
{
  "id": 1,
  "status": "pending",
  "checks": {
    "barcode_check_digit_ok": true,
    "photo_barcode_matches": true,
    "already_on_this_pressing": true,
    "on_other_pressings": [667892, 6925275]
  },
  "agreeing_submitters": 1
}
```

`submitter` is an opaque ID from your app; Open Vinyl doesn't need to know who the person is. Sending the same value twice from the same submitter returns the existing submission.

## Fields

| `target_kind` | Fields |
| - | - |
| `pressing` (needs `release_id`) | `barcode`, `catno`, `label`, `country`, `year`, `runout_a` … `runout_d`, `speed`, `plant`, `color`, `notes`, `album_id` |
| `album` (needs `album_id`) | `title`, `artist`, `year` |
| `new_pressing` (needs `album_id`) | `pressing`: a JSON object with the pressing fields |

## Checks

| Check | When |
| - | - |
| `barcode_check_digit_ok` | Barcode has a valid UPC/EAN check digit |
| `photo_barcode_matches` | `evidence.barcode_decoded` equals the typed barcode |
| `already_on_this_pressing` | The sources already have this value |
| `on_other_pressings` | Other pressings with this barcode |
| `source_values` | What the sources have for this catalog number or runout |
| `same_runout_on_n_pressings` | How many pressings share this exact runout |
| `derived_value` | The derived value for this field, and whether the submission agrees |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.