> For the complete documentation index, see [llms.txt](https://docs.suggestic.com/graphql/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suggestic.com/graphql/query/queries/lab-tests/biomarker-catalog.md).

# Biomarker Catalog

Reference list of biomarker definitions

Use `biomarkerCatalog` to retrieve a referential list of biomarker definitions available in the Suggestic Biomarker Catalog.

Please note that the catalog is for references purpose only. You'll need to create your biomarker definitions using the [addBiomarker ](/graphql/query/mutations/lab-tests/add-biomarker.md)mutation to start using this functionality. Alternatively, you can request we clone some or the totality of biomarkers from the catalog into your account.

### Available Arguments

| Argument             | Type                 | Description                                                                                            |
| -------------------- | -------------------- | ------------------------------------------------------------------------------------------------------ |
| `first`              | String               | Retrieves the first results from the list.                                                             |
| `after`              | String               | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `before`             | String               | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `id`                 | ID                   | Id of Catalog.                                                                                         |
| `last`               | Int                  | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `filters`            | BiomarkerFilterInput |                                                                                                        |
| `filters.categoryId` | ID                   | Id of Category.                                                                                        |
| `filters.name`       | String               | Name of Biomarker.                                                                                     |

### Available Fields

| Field Name         | Type              | Description                                           |
| ------------------ | ----------------- | ----------------------------------------------------- |
| `id`               | ID                | Id of biomarker.                                      |
| `name`             | String            | Name of biomarker.                                    |
| `description`      | String            | Biomarker Description.                                |
| `method`           | String            | BIomarker method definition.                          |
| `createdAt`        | datetime          | Use the format: `YYYY-MM-DDT hh:mm:ssZ`               |
| `updatedAt`        | datetime          | Use the format: `YYYY-MM-DDT hh:mm:ssZ`               |
| `category`         | BiomarkerCategory |                                                       |
| `category.name`    | String            | Biomarker catalog category name.                      |
| `range`            | range             | Biomarker range indicator.                            |
| `range.min`        | Float             | Smallest defined value.                               |
| `range.max`        | Float             | Largest defined value.                                |
| `optimalRange`     | optimalRange      |                                                       |
| `optimalRange.min` | Float             | Smallest defined value to be considered as *optimal*. |
| `optimalRange.max` | Float             | Largest defined value to be considered as *optimal*.  |
| `aliases`          | BiomarkerAlias    | Biomarker Catalog alternative names.                  |
| `aliases.name`     | String            | Alias name.                                           |
| `aliases.laguage`  | String            | Language of the alias.                                |
| `units`            | BiomarkerUnit     |                                                       |
| `units.name`       | String            | Name of unit.                                         |
| `units.factor`     | Float             | Biomarker unit numeric value.                         |

### Example

{% tabs %}
{% tab title="Request" %}

```graphql
query {
  biomarkerCatalog(first: 2) {
    edges {
      node {
        id 
        name 
        description 
        method 
        createdAt 
        updatedAt
        category { 
          name 
          } 
        range { 
          min 
          max
           } 
        optimalRange { 
          min 
          max 
          }
        aliases { 
          name 
          language 
          }
       	units { 
          name 
          factor 
          } 
      }
    }
  }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
query {
  biomarkerCatalog(first: 2) {
    edges {
      node {
        id name description method createdAt updatedAt
        category { name } range { min max } optimalRange { min max }
        aliases { name language }
       	units { name factor } 
      }
    }
  }
}

{
  "data": {
    "biomarkerCatalog": {
      "edges": [
        {
          "node": {
            "id": "QmlvbWFya2VyOjkyNg==",
            "name": "11-Deoxycorticosterone",
            "description": null,
            "method": null,
            "createdAt": "2022-11-09T21:16:21.358432+00:00",
            "updatedAt": "2022-11-09T21:16:21.358464+00:00",
            "category": {
              "name": "Hormonal studies"
            },
            "range": {
              "min": 0.03026,
              "max": 6.0522
            },
            "optimalRange": null,
            "aliases": [
              {
                "name": "Deoxycorticosterone",
                "language": "EN"
              },
              {
                "name": "21-hydroxyprogesterone",
                "language": "EN"
              }
            ],
            "units": [
              {
                "name": "ng/mL",
                "factor": 0.0354371
              },
              {
                "name": "nmol/L",
                "factor": 1
              },
              {
                "name": "ng/dl",
                "factor": 0.030077
              }
            ]
          }
        },
        {
          "node": {
            "id": "QmlvbWFya2VyOjkyOA==",
            "name": "11-Deoxycortisol",
            "description": null,
            "method": null,
            "createdAt": "2022-11-09T21:16:21.402952+00:00",
            "updatedAt": "2022-11-09T21:16:21.402980+00:00",
            "category": {
              "name": "Hormonal studies"
            },
            "range": {
              "min": 0,
              "max": 86.59
            },
            "optimalRange": null,
            "aliases": [
              {
                "name": "cortodoxone",
                "language": "EN"
              },
              {
                "name": "cortexolone",
                "language": "EN"
              }
            ],
            "units": [
              {
                "name": "ng/mL",
                "factor": 0.0354371
              },
              {
                "name": "nmol/L",
                "factor": 1
              },
              {
                "name": "ng/dl",
                "factor": 0.030077
              }
            ]
          }
        }
      ]
    }
  }
}
```

{% endtab %}
{% endtabs %}