For the complete documentation index, see llms.txt. This page is also available as Markdown.

🧩Special Card

Endpoint: /custom-product-card/:id

API URL

Request Method: GET

Header Parameter

parameter
type
definition

Authorization

string

Request Parameters

parameter
type
definition
compulsory

id

integer

The unique product ID assigned to the drug. This information can be retrieved from the id field in the /products endpoint.

no

page

integer

Page number Response Structure

no

per-page

integer

The number of records to return per page. Upper limit is 200. Response Structure

no

Response Parameter

data Response Structure

parameter
type
definition

product

product

card

card

card

parameter
type
definition

drugType

drugType

licenseeCompany

company

indication

text

Drug indication information

prescriptionType

prescriptiontype

ingredients

ingredient[]

barcodes

barcode[]

image

image

price

price

product

parameter
type
definition

id

integer

product unique id

name

string

Product name (constructed in the format: drug + drug form + product).

barcode

parameter
type
definition

barcode

integer

The barcode of the product. It can be 12 or 13 digits.

skrsStatus

string

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).

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.

drugType

parameter
type
definition

id

integer

the id of the drugType belonging to the product

name

string

The name of the drugType.

The returned result may be:;

  • Drug

  • Cosmetic

  • Nutritional Supplement

  • Infant Formula

  • Medical oral nutrition

  • Parenteral nutrition product

  • Intermediate product

  • Enteral nutrition product

  • Irrigation solution

  • Parenteral solution

  • Drug-like

  • OTC

  • Medical product

  • Medical device

  • Gap

  • GBTÜ

prescriptionType

parameter
type
definition

id

integer

the id of the prescriptionType belonging to the product

name

string

The name of the prescription type.

In Türkiye, medications can be prescribed in 7 different types:

White Prescription: A standard prescription type used for most medications.

Restricted White Prescription: A prescription type written by a specialist physician. Controlled Prescription: A prescription type used for medications that could be misused. Red Prescription: A prescription type used for narcotic medications.

Green Prescription: A prescription type used for psychotropic medications.

Purple Prescription: A prescription type used for blood and blood products.

Orange Prescription: A prescription type used for blood factors

ingredient

parameter
type
definition

id

integer

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.

name

string

The name of the active ingredient in a product.

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).

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.

For example ; "parasetamol 100 mg"

  • active ingredient: parasetamol

  • amount: 100

  • unit: mg

alternativeName

string

Alternative names for the active ingredient in the product.

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. For example :

  • paracetamol (acetaminophen)

  • Acetylsalicylic acid (ASA)

amount

integer

The amount of active ingredient in the product

For example; "parasetamol 100 mg"

  • active ingredient: parasetamol

  • amount: 100

  • unit: mg

unit

unit

The unit of active ingredient content. It is the complement of "amount". For details... unit

unit

parameter
type
definition

id

integer

The ID of the unit

name

string

The name of the unit

For example, the returned result could be

  • mg

  • ml

  • mcg

  • L

  • kg

  • mg/ml

  • drops

For example; "parasetamol 100 mg"

  • active ingredient: parasetamol

  • amount: 100

  • unit: mg

image

parameter
type
definition

url

string

URL for the image of the medicine

price

parameter
type
definition

effectiveDate

date

The date on which the price of the drug becomes effective.

Drugs may have more than one price. As prices are updated, new prices are recorded along with their effective dates (effectiveDate).

factory

integer

The price at which the manufacturer sells to pharmaceutical wholesalers (excluding VAT)

storage

integer

The price at which pharmaceutical wholesalers sell to hospitals or pharmacies (excluding VAT)

taxPercent

integer

VAT rate

for example: "8" = %8

retail

integer

Retail price including VAT

storageBased

boolean

true = Pharmaceuticals are classified as wholesale priced products. These products are not sold at retail. Only products sold in hospitals fall into this category. false =

pharmacy

integer

Pharmacy retail price excluding VAT.

publicPrice

integer

Public price determined by SGK (excluding VAT)

publicPriceVat

integer

Public price including VAT.

publicPaidPrice

publicPaidPrice

currencyCode

string

The currency type of the price.

The returned answer could be TRY, USD, EUR.

abroadProduct

boolean

true = Categorized as an imported / non-domestic drug.. false = Categorized as a licensed drug in Turkey.

abroadPublicPaidPrice

integer

The government pays for imported medicines.

abroadPublicPrice

integer

Public price of foreign medicines

abroadRetail

integer

Retail price of medicines from abroad

publicPaidPrice

parameter
type
definition

price

integer

Public price covered by SGK (excluding VAT)

priceVatInc

integer

Public price paid by SGK including VAT.

discountedPriceVatInc

integer

groupCode

string

Equivalent group code determined by SGK (Social Security Institution)

groupLowestUnitPrice

boolean

true = the product with the lowest unit price within the equivalent group false =

licenseeCompany

parameter
type
definition

id

integer

ID belonging to the company that holds the license for the drug.

name

string

The company's short name, For example:

  • Abdi İbrahim

  • Berko

officialname

string

The full name of the company

For example:

  • Abdi İbrahim İlaç Sanayi ve Ticaret Anonim Şirketi

  • Berko İlaç ve Kimya Sanayi Anonim Şirketi

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

curl Request Example

postman Request Example

List Query

Single Query

Response Result

List Result

Singular Result

🧩Use of Special Product Card

Last updated