fatura.app API Dokümantasyonu

API servislerinin teknik kullanımı

fatura.app API'ye Hoş Geldiniz

fatura.app API, vergi kimlik numarası sorgulama ve kredi bakiyesi kontrol etme gibi işlemleri programatik olarak gerçekleştirmenizi sağlar.

Başlarken

API'yi kullanmaya başlamak için aşağıdaki adımları izleyin:

  1. fatura.app hesabınızı oluşturun. (destek@fatura.app adresinden bizimle iletişime geçebilirsiniz.)
  2. İsteklerinizde ApiKey başlığını kullanın

Temel URL

https://api.fatura.app/v1/

Kimlik Doğrulama

Tüm API isteklerinde kimlik doğrulama için ApiKey başlığı kullanılmalıdır.

GET /v1/query.php?TaxNumber={TCKN/VKN} Host: api.fatura.app ApiKey: {API_KEY}

API Endpoints

GET

VKN / TCKN Sorgulama

Vergi kimlik numarası veya TC kimlik numarası ile vergi mükellef bilgilerini sorgulama

GET https://api.fatura.app/v1/query.php
Name Type Required Description
TaxNumber string Yes Sorgulanacak vergi kimlik numarası veya TC kimlik numarası
Name Type Required Description
ApiKey string Yes API erişim anahtarı

Request Example

curl --location 'https://api.fatura.app/v1/query.php?TaxNumber={VKN/TCKN}' \ --header 'ApiKey: {API_KEY}'

Response Example

{ "isError": false, "message": "Sorgu Başarılı", "data": { "taxNumber": "5700020575", "nationalId": "", "firstName": "", "lastName": "", "taxOfficeName": "BÜYÜK MÜKELLEFLER VERGI DAIRESI MÜD.", "taxOfficeCode": "034207", "companyType": "7", "isActive": true, "title": "KOÇ HOLDING ANONIM ŞİRKETİ", "addressInfo": { "neighborhood": "KUZGUNCUK MAH.", "village": "", "street": "AZIZBEY SK.", "buildingNo": "1 G/2", "doorNo": "", "borough": "", "districtName": "ÜSKÜDAR", "cityName": "İSTANBUL", "cityCode": "34", "districtCode": "1708" } } }
GET

Kredi Sorgulama

Kullanıcı hesabının kalan kredi bakiyesini sorgulama

GET https://api.fatura.app/v1/credit.php

No parameters required

Name Type Required Description
ApiKey string Yes API erişim anahtarı

Request Example

curl --location 'https://api.fatura.app/v1/credit.php'\ --header 'ApiKey: {API_KEY}'

Response Example

{ "isError": false, "message": null, "data": { "fullname": "{NAME / TITLE}", "credit": 9927 } }