Merr një klient sipas id (v2): fature.al API

GET /api/v2/clients/{id} Requires authentication Rate limited by the `api-global` limiter v2

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

Kthen klientin në formatin e v2: company ose person sipas type, plus address, contact, customer_number dhe verified.

Është i njëjti klient që kthen edhe v1, vetëm i strukturuar ndryshe. Një klient i krijuar me v1 lexohet këtu pa asnjë hap tjetër.

URL-ja e plotë: https://fature.al/api/v2/clients/{id}

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
id	integer	yes	Id-ja e klientit.

Përgjigjet

200 Klienti te `data.client`, me `company` ose `person` të mbushur sipas llojit të tij.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.client	object
data.client.id	integer	Id-ja e klientit në fature.al
data.client.type	string	`company` ose `person`
data.client.company	object, nullable	I plotësuar kur `type` është `company`, përndryshe null
data.client.company.name	string, nullable	Emri i kompanisë
data.client.company.category	string, nullable	`business`, `bank` ose `exchange`; null kur kompania nuk është klasifikuar
data.client.company.id	object	Identifikuesi fiskal i kompanisë, zakonisht NIPT-i
data.client.company.id.type	any	`nuis`, `vat` ose `tax` te një kompani; `id`, `passport` ose `social` te një person
data.client.company.id.value	any	Vetë identifikuesi; null kur klienti nuk ka asnjë të regjistruar
data.client.person	object, nullable	I plotësuar kur `type` është `person`, përndryshe null
data.client.person.first_name	string, nullable	Emri
data.client.person.last_name	string, nullable	Mbiemri
data.client.person.birthday	string, nullable	Datëlindja, `YYYY-MM-DD`
data.client.person.id	object	Dokumenti i identifikimit të personit
data.client.person.id.type	any	`nuis`, `vat` ose `tax` te një kompani; `id`, `passport` ose `social` te një person
data.client.person.id.value	any	Vetë identifikuesi; null kur klienti nuk ka asnjë të regjistruar
data.client.address	object	Adresa e klientit
data.client.address.line	string, nullable	Rruga dhe numri
data.client.address.city	string, nullable	Qyteti
data.client.address.country	string, nullable	Kodi i shtetit, ISO 3166-1 alpha-3
data.client.contact	object	Telefoni dhe email-i i klientit
data.client.contact.phone	string, nullable	Numri i telefonit
data.client.contact.email	string, nullable	Adresa e email-it
data.client.customer_number	string, nullable	Referenca juaj për këtë klient, kur e keni dhënë
data.client.verified	boolean	true kur identifikuesi i klientit është konfirmuar te administrata tatimore
data.client.created_at	string, nullable	Data dhe ora e krijimit, ISO 8601
data.client.updated_at	string, nullable	Data dhe ora e ndryshimit të fundit, ISO 8601

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

404 Klienti nuk u gjet, ose nuk i përket kompanisë suaj.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

500 Gabim i papritur në server.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

Shembull kërkese

cURL

curl -X GET 'https://fature.al/api/v2/clients/42' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/v2/clients/42');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/clients/42', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

JavaScript

const response = await fetch('https://fature.al/api/v2/clients/42', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Shembull përgjigjeje

200

{
    "status": true,
    "data": {
        "client": {
            "id": 8123,
            "type": "company",
            "company": {
                "name": "Alba Trade shpk",
                "category": "business",
                "id": {
                    "type": "nuis",
                    "value": "K91807012A"
                }
            },
            "person": {
                "first_name": "Arben",
                "last_name": "Hoxha",
                "birthday": "1985-04-21",
                "id": {
                    "type": "nuis",
                    "value": "K91807012A"
                }
            },
            "address": {
                "line": "Rruga e Kavajës 12",
                "city": "Tiranë",
                "country": "ALB"
            },
            "contact": {
                "phone": "+355 69 234 5678",
                "email": "[email protected]"
            },
            "customer_number": "CL-0042",
            "verified": true,
            "created_at": "2026-03-02T09:30:00+01:00",
            "updated_at": "2026-09-10T16:45:00+02:00"
        }
    }
}

401

{
    "message": "Unauthenticated."
}

404

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

500

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}