Getting Started

Welcome to the MasrApp API! This guide will help you set up and start using the API efficiently.

Prerequisites

Before you begin, ensure you have:

An active MasrApp account.
A valid API key for authentication.
Basic knowledge of REST API usage.

Authentication

All API requests must include an API key.

Using API Key in Requests

Header: X-API-KEY: your_api_key
Query Parameter: ?key=your_api_key

Example:

curl -X GET "https://app.masrapp.net/integration/v1/{companyId}/receipts/json" \
     -H "X-API-KEY: your_api_key"

Base URL

https://app.masrapp.net/integration/v1/

Making Your First Request

To retrieve Receipts, send a GET request:

curl -X GET "https://app.masrapp.net/integration/v1/{companyId}/receipts/json" \
     -H "X-API-KEY: your_api_key"

Example JSON Response:

json

{
  "data": [
    {
      "id": "9e43df63-09da-4174-9fc2-aa78db03e5e3",
      "owner": {
        "id": "9e35f6ab-bd06-4ca1-9c7d-1c01e41b2551",
        "name": "Employee User",
        "email": "employee@orneksirket.com"
      },
      "receipt_date": "2025-02-17 00:00:00",
      "receipt_number": "",
      "vendor_id": "9e43df63-0894-4569-a07e-b0ba86a7aafd",
      "vendor": {
        "id": "9e43df63-0894-4569-a07e-b0ba86a7aafd",
        "code": null,
        "name": "BIM BiRLESiK MAGAZALAR A.S.",
        "creator": null,
        "created_at": "2025-02-21T13:11:18.000000Z"
      },
      "budget_id": "",
      "budget": null,
      "items": [
        {
          "id": "9e43df63-0ce9-4e7f-9005-3bc6f2847a89",
          "category": {
            "id": "9e35ec37-b08c-462f-9207-207682b87f5b",
            "code": "PAZ01",
            "name": "Pazarlama ve Reklam",
            "status": 1,
            "created_at": "2025-02-14T14:45:35.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
            "name": "%1 KDV",
            "rate": 1
          },
          "description": "TAZE KASAR 700G",
          "total": 215,
          "tax": 2.13,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-0e65-467c-b37c-4fb17cc19800",
          "category": {
            "id": "9e35ec37-b08c-462f-9207-207682b87f5b",
            "code": "PAZ01",
            "name": "Pazarlama ve Reklam",
            "status": 1,
            "created_at": "2025-02-14T14:45:35.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
            "name": "%1 KDV",
            "rate": 1
          },
          "description": "SEKER KUP 1KG",
          "total": 44.5,
          "tax": 0.44,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-0fab-4cbd-97c4-1500b602a650",
          "category": {
            "id": "9e35ec37-b08c-462f-9207-207682b87f5b",
            "code": "PAZ01",
            "name": "Pazarlama ve Reklam",
            "status": 1,
            "created_at": "2025-02-14T14:45:35.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
            "name": "%1 KDV",
            "rate": 1
          },
          "description": "DOMATES SALCASI 830G",
          "total": 38,
          "tax": 0.38,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-10a0-4292-83c2-56f92f2832e6",
          "category": {
            "id": "9e35ec37-b08c-462f-9207-207682b87f5b",
            "code": "PAZ01",
            "name": "Pazarlama ve Reklam",
            "status": 1,
            "created_at": "2025-02-14T14:45:35.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
            "name": "%1 KDV",
            "rate": 1
          },
          "description": "BALDO PiRiNC 2,5KG",
          "total": 172.5,
          "tax": 1.71,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-114d-4dab-a131-ec2dc6e46cb9",
          "category": {
            "id": "9e35ec37-b08c-462f-9207-207682b87f5b",
            "code": "PAZ01",
            "name": "Pazarlama ve Reklam",
            "status": 1,
            "created_at": "2025-02-14T14:45:35.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
            "name": "%1 KDV",
            "rate": 1
          },
          "description": "MERCIMEK YESiL 1 KG",
          "total": 59.75,
          "tax": 0.59,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-0b98-4db2-9df6-4c753f75fc75",
          "category": {
            "id": "9e35ec4e-155c-45e4-9712-30d922bb8c6a",
            "code": "OF01",
            "name": "Ofis ve İşletme Giderleri",
            "status": 1,
            "created_at": "2025-02-14T14:45:49.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-bb7b-4cb3-b470-4ee789dde7aa",
            "name": "%20 KDV",
            "rate": 20
          },
          "description": "TUVALET KAGIDI 12Li",
          "total": 109.75,
          "tax": 18.29,
          "created_at": "2025-02-21T13:11:18.000000Z"
        },
        {
          "id": "9e43df63-1247-44be-ac4f-543fd2d32ace",
          "category": {
            "id": "9e35ec4e-155c-45e4-9712-30d922bb8c6a",
            "code": "OF01",
            "name": "Ofis ve İşletme Giderleri",
            "status": 1,
            "created_at": "2025-02-14T14:45:49.000000Z"
          },
          "tax_rate": {
            "id": "9e35e60a-bb7b-4cb3-b470-4ee789dde7aa",
            "name": "%20 KDV",
            "rate": 20
          },
          "description": "ALISVER1$ POSETI BIM",
          "total": 0.5,
          "tax": 0.08,
          "created_at": "2025-02-21T13:11:18.000000Z"
        }
      ],
      "manager_response": 0,
      "manager_response_note": null,
      "finance_manager_response": 0,
      "finance_manager_response_note": null,
      "total": 640,
      "tax": 23.62,
      "created_at": "2025-02-21T13:11:18.000000Z"
    }
  ],
  "links": {
    "first": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
    "last": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "\" Öncesi",
        "active": false
      },
      {
        "url": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Sonraki \"",
        "active": false
      }
    ],
    "path": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json",
    "per_page": 50,
    "to": 1,
    "total": 1
  }
}

Next Steps

Learn about Error Handling & Pagination
Start integrating your system with Receipts, Vendors, Categories, and Budgets.

Getting Started ​

Prerequisites ​

Authentication ​

Using API Key in Requests ​

Base URL ​

Making Your First Request ​