A File represents metadata about a binary file.

Links are provided for both upload and download of the actual binary content. See ch:data for more information about uploading and retrieving binary content.


name type read-only
label string true
content_type string false
name string false
size integer false
rel conditional
self false
ch:application1 true
ch:comments1 true
ch:data false
ch:dispute1 true
ch:person1 true
Presence depends on file ownership context.

Additional semantics

No additional semantics.

Example representation

  "label": "bank_statement",
  "name": "bank_statement",
  "content_type": "application/pdf",
  "_links": {
    "self": {
      "href": ""
    "ch:application": {
      "href": ""
    "ch:comments": {
      "href": "{?page,per_page}"
    "ch:data": [
        "href": "",
        "name": "upload"
        "href": "",
        "name": "download"
    "curies": [
        "href": "{rel}",
        "templated": true,
        "name": "ch"
Open Navigation Close Navigation