Interaction

Endpoint: /product-interaction

API URL

Request Method: POST

Header Parameters

parameter	type	definition
Authorization	string	Bearer <API Key>Interaction Identity Verfication

Body Parameters

parameter	type	definition	compulsory
products	array	List of drugs whose interactions will be checked.	yes
products[].id	integer	Unique ID for the drug whose interaction will be checked.	yes

Response Parameters

data Response Structure

parameter	type	definition
product	object	Contains information on the primary interacting drug.
affectingProduct	object	Contains information on other drugs affecting the primary drug.
description	string	Description and warning text of the medical interaction between two drugs.
color	object	Color and priority details indicating the risk/severity level of the interaction.
success	boolean	Indicates whether the request was successful (true/false).

product / affectingProduct Details

parameter	type	definition
id	integer	Unique ID of the drug.
name	string	Full name of the drug (including drug + drugform details).
barcode	string	Barcode number of the drug.

color Details

parameter	type	definition
id	integer	Unique ID of the color level.
name	string	Color name (e.g., orange, yellow). Indicates the severity of the interaction.
priority	integer	Priority/severity degree of the interaction.
htmlCode	string	HEX code of the color for use in UI displays (e.g., #FF9900).

curl Request Example

Bash
curl --location 'https://api.vapi.co/product-interaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API Key>' \
--data '{
    "products": [
        {
            "id": 5890
        },
        {
            "id": 19301
        },
        {
            "id": 23966
        }
    ]
}'

postman Request Example

Response Example

{
    "data": [
        {
            "product": {
                "id": 201,
                "name": "COUMADİN Tablet 10 mg 25 tabletlik ambalaj",
                "barcode": "8699502010253"
            },
            "affectingProduct": {
                "id": 6834,
                "name": "ARVELES Film Kaplı Tablet 25 mg 20 tabletlik ambalaj",
                "barcode": "8699832090055"
            },
            "description": "NSAİİ'ler antikoagülanların etkililiğini artırabilir. Kombine tedavide hastalar yakından takip edilmelidir. ",
            "color": {
                "id": 3,
                "name": "turuncu",
                "priority": 2,
                "htmlCode": "#FF9900"
            }
        },
        {
            "product": {
                "id": 201,
                "name": "COUMADİN Tablet 10 mg 25 tabletlik ambalaj",
                "barcode": "8699502010253"
            },
            "affectingProduct": {
                "id": 6834,
                "name": "ARVELES Film Kaplı Tablet 25 mg 20 tabletlik ambalaj",
                "barcode": "8699832090055"
            },
            "description": " NSAii'ler ile varfarinin gastrointestinal kanama üzerindeki etkisi sinerjiktir. Varfarin ile NSAİİ'ler mümkünse eşzamanlı kullanılmamalı veya  klinik ve laboratuvar gözetimi artırılarak dikkatle uygulanmalıdır. \r\n",
            "color": {
                "id": 3,
                "name": "turuncu",
                "priority": 2,
                "htmlCode": "#FF9900"
            }
        },
        {
            "product": {
                "id": 201,
                "name": "COUMADİN Tablet 10 mg 25 tabletlik ambalaj",
                "barcode": "8699502010253"
            },
            "affectingProduct": {
                "id": 6834,
                "name": "ARVELES Film Kaplı Tablet 25 mg 20 tabletlik ambalaj",
                "barcode": "8699832090055"
            },
            "description": "Bütün NSAID'ler kanama riskini artırır ve kanama riski antikoagülanlarla kombine edildiklerinde artar. ",
            "color": {
                "id": 1,
                "name": "sarı",
                "priority": 3,
                "htmlCode": "#F7F700"
            }
        }
    ],
    "success": true
}
            "href": "https://api.vapi.co/products?page=2&per-page=500"
        }
    },
    "_meta": {
        "totalCount": 27018,
        "pageCount": 55,
        "currentPage": 1,
        "perPage": 500
    },
    "success": true
}

🔎Drug Search