Vendors API

The Vendors API provides endpoints to get vendors.

Get Vendors (JSON)

Endpoint:

GET /{companyId}/vendors/json

Query Parameters:

• start_date (optional) - Filter receipts from this date.
• end_date (optional) - Filter receipts up to this date.
• order_by (optional, default: created_at) - Sorting field.
• order_direction (optional, default: desc) - Sorting order.

Example Request:

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

Example Response:

{
  "data": [
    {
      "id": "9e43df63-0894-4569-a07e-b0ba86a7aafd",
      "code": null,
      "name": "BIM BiRLESiK MAGAZALAR A.S.",
      "creator": null,
      "created_at": "2025-02-21T13:11:18.000000Z"
    }
  ],
  "links": {
    "first": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/vendors/json?page=1",
    "last": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/vendors/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/vendors/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/vendors/json",
    "per_page": 50,
    "to": 1,
    "total": 1
  }
}

Get Vendors (XML)

Endpoint:

GET /{companyId}/vendors/xml

Example Request:

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

Example Response:

<?xml version="1.0" encoding="utf-8"?>
<root>
    <data>
        <item>
            <id>9e43df63-0894-4569-a07e-b0ba86a7aafd</id>
            <code></code>
            <name>BIM BiRLESiK MAGAZALAR A.S.</name>
            <creator></creator>
            <created_at>2025-02-21T13:11:18.000000Z</created_at>
        </item>
    </data>
    <links>
        <first>https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/vendors/xml?page=1</first>
        <last>https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/vendors/xml?page=1</last>
        <prev></prev>
        <next></next>
    </links>
    <meta>
        <current_page>1</current_page>
        <from>1</from>
        <last_page>1</last_page>
        <per_page>50</per_page>
        <to>1</to>
        <total>1</total>
    </meta>
</root>