---
title: Documents by company api
description: Provides information on a specific companies documents
---

[Skip to content](https://support.datapharm.com/emc-api/emc-documents-by-company-api#main-content)

English - United Kingdom

Show submenu for translations

![](https://support.datapharm.com/hs-fs/hubfs/Datapharm_RGB_Logo1-2.png?width=433&height=100&name=Datapharm_RGB_Logo1-2.png)

- [Datapharm homepage](https://www.datapharm.com/)

Open main navigation

Close main navigation

- [Datapharm homepage](https://www.datapharm.com/)
- English - United Kingdom
  
  Show submenu for translations
- Contact us

 Contact us

 How can we help you?

- There are no suggestions because the search field is empty.

1. [emc api](https://support.datapharm.com/emc-api?hsLang=en-gb)
2. [Existing apis](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb)
3. [emc Documents api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-documents-api)

# Documents by company api

## Provides information on a specific companies documents

### **URL - endpoint**

> https://apim.medicines.org.uk/public\_api/v1/companies/{company}/documents

### **Metadata returned**

- id (Content id - unique identifier)
- Version (The current version number of the SmPC/PIL/RMM)
- Title (Content title - The title of the document )
- Type (SPC/PIL)
- Active Ingredients (A list of name(s) of the active ingredient(s) ) 
    - id (ingredient id - unique identifier)
    - name (ingredient name)
- Company 
    - id (company id - unique identifier)
    - name (company name)
- Authorisation date (date published to emc)
- Retired date (date removed from emc)
- Last modified date
- is Black triangle (Is this product subject to additional monitoring)
- is discontinued
- State (Whether the SmPC/PIL is published (authorised) or removed (retired) from the emc)
- Legal categories  
    - Id (Legal Category id - unique identifier
    - name (Category name)
- emc url
- Discontinued items
- Has Xpil
- Content url
- Versions
- Rmms 
    - id
    - Title
    - Description
    - Media Type
    - Content
    - Audience
    - CPN
    - Company id
- Has Rmm *boolean (true/false)*
- Cpn (Product Family)
- Related AMPs  
    - AMP id
    - AMP description

**Settings** 

**query parameters**

- **type**
- **limit** *integer*(the maximum number of results that will be returned)
- **offset** *integer* (this is used to exclude from a response the first N results from being returned)
- **publishedDateTo** *date (yyyy/mm/dd)*
- **daysOffset**
- **state** *authorised/retired*
- **lastModifiedDateTo** *date (yyyy/mm/dd)*

**Request/Response Formats**

*Request options*

GET 

*Response formats*

JSON, XML 

**example** 

```
 {            "Id": 21377,            "Version": 21,            "Title": "Abstral Sublingual Tablets",            "Type": "PIL",            "ActiveIngredients": [                {                    "Id": 1749,                    "Name": "fentanyl citrate"                }            ],            "Company": {                "Id": 4258,                "Name": "Grunenthal Meds"            },            "AuthorisationDate": "2024-12-20T13:53:49.1027436",            "RetiredDate": "0001-01-01T00:00:00",            "LastModifiedDate": "2024-12-20T13:53:49.1027436",            "IsBlackTriangle": false,            "IsDiscontinued": false,            "State": "Authorised",            "LegalCategories": [                {                    "Id": 1,                    "Name": "POM"                }            ],            "EmcUrl": "https://www.medicines.org.uk/emc/medicine/21377/pil",            "DiscontinuedItems": [],            "HasXpil": true,            "ContentUrl": "https://api.medicines.org.uk/v1/files/PIL.21377.21.pdf",            "Versions": [                1,                2,                3,                4,                5,                6,                7,                8,                9,                10,                11,                12,                13,                14,                15,                16,                17,                18,                19,                20,                21            ],            "Rmms": [                {                    "Id": 101006,                    "Title": "Abstral - UK Pharmacist Guide",                    "Description": "Important risk minimisation information, on Abstral (fentanyl citrate) sublingual tablet, for pharmacists",                    "MediaType": "Document",                    "Content": "files/RMM.101006.pdf",                    "Audience": [                        "HCP"                    ],                    "Cpn": "Abstral",                    "CompanyId": 4258                },                {                    "Id": 2894,                    "Title": "Abstral - UK Patient and Carer guide",                    "Description": "Important risk minimisation information, on Abstral (fentanyl citrate) sublingual tablet, for patients prescribed Abstral and their carers",                    "MediaType": "Document",                    "Content": "files/RMM.2894.pdf",                    "Audience": [                        "Public"                    ],                    "Cpn": "Abstral",                    "CompanyId": 4258                },                {                    "Id": 2893,                    "Title": "Abstral - UK Prescriber Guide",                    "Description": "Important risk minimisation information, on Abstral (fentanyl citrate) sublingual tablet, for physicians",                    "MediaType": "Document",                    "Content": "files/RMM.2893.pdf",                    "Audience": [                        "HCP"                    ],                    "Cpn": "Abstral",                    "CompanyId": 4258                }            ],            "HasRmm": true,            "Cpn": "Abstral",            "RelatedAmps": []        }
```

**Authentication**

apiKey

- [Existing apis](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#main-content)

    - [emc Documents api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-documents-api)
    - [emc amps api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-amps-api)
    - [emc active ingredients api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-active-ingredients-api)
    - [emc Companies api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-companies-api)
    - [emc SmPCs api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-smpcs-api)
    - [emc PILs api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-pils-api)
    - [emc RMMs api](https://support.datapharm.com/emc-api/existing-apis?hsLang=en-gb#emc-rmms-api)

- [Datapharm homepage](https://www.datapharm.com/)

[![](https://support.datapharm.com/hs-fs/hubfs/Datapharm_RGB_Logo1-2.png?width=433&height=100&name=Datapharm_RGB_Logo1-2.png)](http://www.medicines.org.uk)

Can't find what you need?

 Please email us at servicedesk@datapharm.com or call us on 01372 371 444

[mailto:email@email.com](mailto:email@email.com)

Copyright © 2025, Datapharm Ltd