> For the complete documentation index, see [llms.txt](https://doc.vapi.co/tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.vapi.co/tr/en/tr-turkey-datasets-and-api-reference/medicines/special-card.md).

# Special Card

### Endpoint: /custom-product-card/:id

[API URL](https://doc.vapi.co/tr/api-klavuzu/api-url)

### Request Method: <mark style="color:green;">GET</mark>

### Header Parameter

<table><thead><tr><th width="154">parameter</th><th width="108">type</th><th>definition</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer &#x3C;API Key><a data-mention href="#curl-istek-oernegi">#curl-istek-oernegi</a> <a data-mention href="/tr/en/getting-started/identity-verfication.md">Identity Verfication</a></td></tr></tbody></table>

### Request Parameters

<table><thead><tr><th width="153">parameter</th><th width="110">type</th><th width="367">definition</th><th>compulsory</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>The unique product ID assigned to the drug. This information can be retrieved from the id field in the /products endpoint.</td><td>no</td></tr><tr><td>page</td><td>integer</td><td>Page number <a data-mention href="/tr/en/getting-started/response-structure.md">Response Structure</a></td><td>no</td></tr><tr><td>per-page</td><td>integer</td><td>The number of records to return per page. Upper limit is 200. <a data-mention href="/tr/en/getting-started/response-structure.md">Response Structure</a></td><td>no</td></tr></tbody></table>

### Response Parameter

#### <mark style="color:green;">data</mark> [Response Structure](/tr/en/getting-started/response-structure.md)

<table><thead><tr><th width="232">parameter</th><th width="222">type</th><th>definition</th></tr></thead><tbody><tr><td>product</td><td>product</td><td><a data-mention href="#product">#product</a></td></tr><tr><td>card</td><td>card</td><td><a data-mention href="#card">#card</a></td></tr></tbody></table>

#### <mark style="color:green;">card</mark>

<table><thead><tr><th width="235.296875">parameter</th><th width="218.26953125">type</th><th>definition</th></tr></thead><tbody><tr><td>drugType</td><td>drugType </td><td><a data-mention href="#drugtype">#drugtype</a></td></tr><tr><td>licenseeCompany</td><td> company</td><td><a data-mention href="#licenseecompany">#licenseecompany</a></td></tr><tr><td>indication</td><td> text</td><td>Drug indication information</td></tr><tr><td>prescriptionType</td><td> prescriptiontype</td><td><a data-mention href="#prescriptiontype">#prescriptiontype</a></td></tr><tr><td>ingredients</td><td>ingredient[]</td><td><a data-mention href="#ingredient">#ingredient</a></td></tr><tr><td>barcodes</td><td>barcode[]</td><td><a data-mention href="#barcode">#barcode</a></td></tr><tr><td>image</td><td>image</td><td><a data-mention href="#image">#image</a></td></tr><tr><td>price</td><td>price</td><td><a data-mention href="#price">#price</a></td></tr></tbody></table>

#### <mark style="color:green;">product</mark>

<table><thead><tr><th width="137">parameter</th><th width="105">type</th><th>definition</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>product unique id</td></tr><tr><td>name</td><td>string</td><td><p>Product name (constructed in the format: drug + drug form + product).</p><p></p><p><img src="https://content.gitbook.com/content/yoqXCLsgP4CqhklelIUV/blobs/EUH0b4O85R6hDLSJpl5t/image.png" alt="" data-size="original"></p><p> </p></td></tr></tbody></table>

#### <mark style="color:green;">barcode</mark>

<table><thead><tr><th width="117">parametre</th><th width="123">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>barcode</td><td>integer</td><td>The barcode of the product. It can be 12 or 13 digits.</td></tr><tr><td>skrsStatus</td><td>string</td><td><p>The SKRS status associated with the barcode. It describes the barcode defined in the Health Coding Reference Server (SKRS) and its current status. The returned value will be active, passive, or null (unlisted).</p><p>A drug's barcode may change under certain conditions. For this reason, a single drug can have multiple barcodes (the same drug may exist in the market under different barcodes), and each barcode may have a different SKRS status.</p></td></tr></tbody></table>

#### <mark style="color:green;">drugType</mark>

<table><thead><tr><th width="123">parametre</th><th width="119">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>the id of the drugType belonging to the product</td></tr><tr><td>name</td><td>string</td><td><p>The name of the drugType.</p><p></p><p>The returned result may be:; </p><ul><li>Drug</li><li>Cosmetic</li><li>Nutritional Supplement</li><li>Infant Formula</li><li>Medical oral nutrition</li><li>Parenteral nutrition product</li><li>Intermediate product</li><li>Enteral nutrition product</li><li>Irrigation solution</li><li>Parenteral solution</li><li>Drug-like</li><li>OTC</li><li>Medical product</li><li>Medical device</li><li>Gap</li><li>GBTÜ</li></ul></td></tr></tbody></table>

#### <mark style="color:green;">prescriptionType</mark>

<table><thead><tr><th width="124">parameter</th><th width="115">type</th><th>definition</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>the id of the prescriptionType belonging to the product</td></tr><tr><td>name</td><td>string</td><td><p>The name of the prescription type.</p><p><br>In Türkiye, medications can be prescribed in 7 different types:</p><p>White Prescription: A standard prescription type used for most medications.</p><p>Restricted White Prescription: A prescription type written by a specialist physician.<br>Controlled Prescription: A prescription type used for medications that could be misused.<br>Red Prescription: A prescription type used for narcotic medications.</p><p>Green Prescription: A prescription type used for psychotropic medications.</p><p>Purple Prescription: A prescription type used for blood and blood products.</p><p>Orange Prescription: A prescription type used for blood factors</p></td></tr></tbody></table>

#### <mark style="color:green;">ingredient</mark>

<table><thead><tr><th width="134">parametre</th><th width="113">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>The ID of the active ingredient in the product. A product may contain more than one active ingredient. In this case, the result will return a different ID for each active ingredient.</td></tr><tr><td>name</td><td>string</td><td><p>The name of the active ingredient in a product.<br></p><p>It is the chemical component that provides the therapeutic or treatment effects of a drug. This substance is known as the main active ingredient of the drug (also referred to as the active substance in some sources).<br></p><p>The active ingredient of a drug is the most important component in the drug's formulation and provides its therapeutic effects. Therefore, the active ingredient is usually indicated on drug labels, and doctors, pharmacists, or healthcare professionals pay attention to this substance when prescribing.<br></p><p>For example ; "parasetamol 100 mg" </p><ul><li>active ingredient: parasetamol</li><li>amount: 100</li><li>unit: mg</li></ul></td></tr><tr><td>alternativeName</td><td>string</td><td><p>Alternative names for the active ingredient in the product.<br></p><p>Active ingredients may be known by alternative names in different fields. For example, the active ingredient known as paracetamol in European countries is known as acetaminophen in the USA. Or, acetylsalicylic acid may be abbreviated as ASA in some sources.<br><br>For example : </p><ul><li>paracetamol (acetaminophen)</li><li>Acetylsalicylic acid (ASA)</li></ul></td></tr><tr><td>amount</td><td>integer</td><td><p>The amount of active ingredient in the product<br></p><p>For example; "parasetamol 100 mg" </p><ul><li>active ingredient: parasetamol</li><li>amount: 100 </li><li>unit: mg</li></ul></td></tr><tr><td>unit</td><td>unit </td><td>The unit of active ingredient content. It is the complement of "amount". For details... <a data-mention href="#unit">#unit</a></td></tr></tbody></table>

#### <mark style="color:green;">unit</mark>

<table><thead><tr><th width="134">parameter</th><th width="112">type</th><th>definition</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>The ID of the unit</td></tr><tr><td>name</td><td>string</td><td><p>The name of the unit<br></p><p>For example, the returned result could be</p><ul><li>mg</li><li>ml</li><li>mcg</li><li>L</li><li>kg</li><li>mg/ml</li><li>drops<br></li></ul><p>For example; "parasetamol 100 mg" </p><ul><li>active ingredient: parasetamol</li><li>amount: 100 </li><li>unit: mg</li></ul></td></tr></tbody></table>

#### <mark style="color:green;">image</mark>

<table><thead><tr><th width="208">parameter</th><th width="222">type</th><th>definition</th></tr></thead><tbody><tr><td>url</td><td>string</td><td>URL for the image of the medicine</td></tr></tbody></table>

#### <mark style="color:green;">price</mark>

<table><thead><tr><th width="221">parameter</th><th width="222">type</th><th>definition</th></tr></thead><tbody><tr><td>effectiveDate</td><td>date</td><td><p>The date on which the price of the drug becomes effective.</p><p>Drugs may have more than one price. As prices are updated, new prices are recorded along with their effective dates (effectiveDate).</p></td></tr><tr><td>factory</td><td>integer</td><td>The price at which the manufacturer sells to pharmaceutical wholesalers (excluding VAT)</td></tr><tr><td>storage</td><td>integer</td><td>The price at which pharmaceutical wholesalers sell to hospitals or pharmacies (excluding VAT)</td></tr><tr><td>taxPercent</td><td>integer</td><td><p>VAT rate<br></p><p>for example:<br>"8" = %8</p></td></tr><tr><td>retail</td><td>integer</td><td>Retail price including VAT</td></tr><tr><td>storageBased</td><td>boolean</td><td><mark style="color:green;">true =</mark> Pharmaceuticals are classified as wholesale priced products. These products are not sold at retail. Only products sold in hospitals fall into this category.<br><mark style="color:red;">false =</mark> </td></tr><tr><td>pharmacy</td><td>integer</td><td>Pharmacy retail price excluding VAT.</td></tr><tr><td>publicPrice</td><td>integer</td><td>Public price determined by SGK (excluding VAT)</td></tr><tr><td>publicPriceVat</td><td>integer</td><td>Public price including VAT.</td></tr><tr><td>publicPaidPrice</td><td>publicPaidPrice </td><td><a data-mention href="#publicpaidprice">#publicpaidprice</a></td></tr><tr><td>currencyCode</td><td>string</td><td><p>The currency type of the price.</p><p>The returned answer could be TRY, USD, EUR.</p></td></tr><tr><td>abroadProduct</td><td>boolean</td><td><mark style="color:green;">true =</mark> Categorized as an imported / non-domestic drug..<br><mark style="color:red;">false =</mark> Categorized as a licensed drug in Turkey.</td></tr><tr><td>abroadPublicPaidPrice</td><td>integer</td><td>The government pays for imported medicines.</td></tr><tr><td>abroadPublicPrice</td><td>integer</td><td>Public price of foreign medicines</td></tr><tr><td>abroadRetail</td><td>integer</td><td>Retail price of medicines from abroad</td></tr></tbody></table>

#### <mark style="color:green;">publicPaidPrice</mark>

<table><thead><tr><th width="222">parameter</th><th width="222">type</th><th>definition</th></tr></thead><tbody><tr><td>price</td><td>integer</td><td>Public price covered by SGK (excluding VAT)</td></tr><tr><td>priceVatInc</td><td>integer</td><td>Public price paid by SGK including VAT.</td></tr><tr><td>discountedPriceVatInc</td><td>integer</td><td></td></tr><tr><td>groupCode</td><td>string</td><td>Equivalent group code determined by SGK (Social Security Institution)</td></tr><tr><td>groupLowestUnitPrice</td><td>boolean</td><td>true = the product with the lowest unit price within the equivalent group
<br>false =</td></tr></tbody></table>

#### <mark style="color:green;">licenseeCompany</mark>

|              |         |                                                                                                                                                                              |
| ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id           | integer | ID belonging to the company that holds the license for the drug.                                                                                                             |
| name         | string  | <p>The company's short name, <br><br>For example:</p><ul><li>Abdi İbrahim</li><li>Berko</li></ul>                                                                            |
| officialname | string  | <p>The full name of the company</p><p>For example:</p><ul><li>Abdi İbrahim İlaç Sanayi ve Ticaret Anonim Şirketi</li><li>Berko İlaç ve Kimya Sanayi Anonim Şirketi</li></ul> |
| website      | string  | website                                                                                                                                                                      |
| fax          | string  | fax number                                                                                                                                                                   |
| phone        | string  | phone number                                                                                                                                                                 |
| address      | string  | full address                                                                                                                                                                 |
| email        | string  | email address                                                                                                                                                                |
| city         | string  | province                                                                                                                                                                     |
| district     | string  | district                                                                                                                                                                     |

#### &#x20; <a href="#curl-istek-ornegi" id="curl-istek-ornegi"></a>

### <mark style="color:blue;">curl</mark> Request Example

```powershell
curl --location 'https://api.vapi.co/custom-product-card' \
--header 'Authorization: Bearer <API Anahtarı>'
```

```
curl --location 'https://api.vapi.co/custom-product-card/3195' \
--header 'Authorization: Bearer <API Anahtarı>'
```

### <mark style="color:blue;">postman</mark> Request Example

**List Query**

<figure><img src="https://content.gitbook.com/content/yoqXCLsgP4CqhklelIUV/blobs/CNpTH86YXeuQ3hpXZn5w/image.png" alt=""><figcaption></figcaption></figure>

**Single Query**

<figure><img src="https://content.gitbook.com/content/yoqXCLsgP4CqhklelIUV/blobs/JxcLaNZc2Ay4G4U9HQrX/image.png" alt=""><figcaption></figcaption></figure>

### Response Result

**List Result**

```json
{
   "data":[
      {
         "product":{
            "id":4222,
            "name":"KATARİN Kapsül 250 mg/100 mg/2 mg 30 kapsüllük ambalaj"
         },
         "card":{
            "drugType":{
               "id":1,
               "name":"İlaç"
            },
            "licenseeCompany":{
               "id":18,
               "name":"Biofarma",
               "officialName":"Biofarma İlaç Sanayi ve Ticaret Anonim Şirketi",
               "website":"http://www.biofarma.com.tr",
               "fax":"0216 398 10 20",
               "phone":"0216 398 10 63",
               "address":"Akpınar Mah. Osmangazi Cad. No:156",
               "email":"info@biofarma.com.tr",
               "city":"İstanbul",
               "district":"Sancaktepe"
            },
            "indication":"Analjezik, antipiretik, dekonjestan ve antitüssif etkilidir. Ağrı kesici ve ateş düşürücü olarak soğuk algınlığı, nezle, grip, rinit, farenjit, sinüzit, bronşit ve larenjit gibi üst solunum yollarının akut enfeksiyonlarında semptomatik tedavide endikedir.",
            "prescriptionType":{
               "id":1,
               "name":"Beyaz Reçete"
            },
            "ingredients":[
               {
                  "id":1536,
                  "name":"Oksolamin",
                  "alternativeName":[
                     "Oksolamin"
                  ],
                  "amount":100,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               },
               {
                  "id":417,
                  "name":"Klorfeniramin",
                  "alternativeName":[
                     "Klorfeniramin",
                     "Klorfenamin"
                  ],
                  "amount":2,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               },
               {
                  "id":1565,
                  "name":"Parasetamol",
                  "alternativeName":[
                     "Parasetamol",
                     "Asetaminofen"
                  ],
                  "amount":250,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               }
            ],
            "barcodes":[
               {
                  "barcode":"8699578152215",
                  "skrsStatus":"Aktif"
               }
            ],
            "image":[
               {
                  "url":"https://files.vademecumonline.com.tr/PictureFile/middle/4222_8699578152215_1623577218.jpg",
                  "thumbnailUrl":"https://files.vademecumonline.com.tr/PictureFile/middle/thumbnail/4222_8699578152215_1623577218.jpg"
               }
            ],
            "price":{
               "effectiveDate":"2025-05-20",
               "factory":55.16,
               "storage":59.57,
               "taxPercent":10,
               "retail":83.87,
               "storageBased":false,
               "pharmacy":76.25,
               "discountRate":0,
               "publicPrice":76.25,
               "publicPriceVat":83.87,
               "publicPaidPrice":[
                  {
                     "price":76.25,
                     "priceVatInc":83.87,
                     "discountedPriceVatInc":80.93,
                     "groupCode":null,
                     "groupLowestUnitPrice":false
                  }
               ],
               "currencyCode":"TRY",
               "abroadProduct":false,
               "abroadPublicPaidPrice":null,
               "abroadPublicPrice":null,
               "abroadRetail":null
            }
         }
         ....
      }
   ],
   "_links":{
      "self":{
         "href":"https://api.vapi.co/custom-product-card?page=1"
      },
      "first":{
         "href":"https://api.vapi.co/custom-product-card?page=1"
      },
      "last":{
         "href":"https://api.vapi.co/custom-product-card?page=4"
      },
      "next":{
         "href":"https://api.vapi.co/custom-product-card?page=2"
      }
   },
   "_meta":{
      "totalCount":76,
      "pageCount":4,
      "currentPage":1,
      "perPage":20
   },
   "success":true
}
```

**Singular Result**

```json
{
    "data": {
        "product": {
            "id": 3195,
            "name": "ASPİRİN Tablet 100 mg (Çocuklar için) 20 tabletlik ambalaj"
        },
        "card": {
            "drugType": {
                "id": 1,
                "name": "İlaç"
            },
            "licenseeCompany": {
                "id": 14,
                "name": "Bayer",
                "officialName": "Bayer Türk Kimya Sanayi Limited Şirketi",
                "website": "http://www.bayer.com.tr",
                "fax": "0216 527 87 00",
                "phone": "0216 528 36 00",
                "address": "Fatih Sultan Mehmet Mah. Balkan Cad. No:53",
                "email": "bilgi@bayer.com.tr",
                "city": "İstanbul",
                "district": "Ümraniye"
            },
            "indication": "<p>Analjezik, antipiretik, antiromatizmal ve antiagregandır. </p> <p> </p>",
            "prescriptionType": {
                "id": 1,
                "name": "Beyaz Reçete"
            },
            "ingredients": [
                {
                    "id": 2247,
                    "name": "Asetilsalisilik asit",
                    "alternativeName": [
                        "Asetilsalisilik asit"
                    ],
                    "amount": 100,
                    "unit": {
                        "id": 1,
                        "name": "mg"
                    }
                }
            ],
            "barcodes": [
                {
                    "barcode": "8699546010028",
                    "skrsStatus": "Aktif"
                },
                {
                    "barcode": "8699546010028",
                    "skrsStatus": "Aktif"
                }
            ],
            "image": [
                {
                    "url": "https://files.vademecumonline.com.tr/PictureFile/middle/ASPIRIN_100_mg_20_tab_cocuk.png",
                    "thumbnailUrl": "https://files.vademecumonline.com.tr/PictureFile/middle/thumbnail/ASPIRIN_100_mg_20_tab_cocuk.png"
                }
            ],
            "price": {
                "effectiveDate": "2024-10-25",
                "factory": 44.28,
                "storage": 47.82,
                "taxPercent": 10,
                "retail": 67.33,
                "storageBased": false,
                "pharmacy": 61.21,
                "discountRate": 0,
                "publicPrice": 61.21,
                "publicPriceVat": 67.33,
                "publicPaidPrice": [
                    {
                        "price": 32.15,
                        "priceVatInc": 35.37,
                        "discountedPriceVatInc": 34.13,
                        "groupCode": "TR-020B",
                        "groupLowestUnitPrice": false
                    }
                ],
                "currencyCode": "TRY",
                "abroadProduct": false,
                "abroadPublicPaidPrice": null,
                "abroadPublicPrice": null,
                "abroadRetail": null
            }
        }
    },
    "success": true
}
```

{% content-ref url="/pages/mq0NNhIoyDG6CVwoCqfQ" %}
[Use of Special Product Card](/tr/en/tr-turkey-datasets-and-api-reference/use-of-special-product-card.md)
{% endcontent-ref %}