Get One POS Category

Endpoint Overview

This API endpoint is designed to fetch detailed information about a specific single POS category from the Juleb ERP system, by providing the ID of the desired record.

Endpoint Details

• Method: GET
• URL: /api/v1/pos/pos-category/{id}

Parameters

• Path Parameters:
  • id (string, required): The ID of the record to retrieve.
• Query Parameters:
  • fields (string, not required): Fields to include in the response separated by comma. If not provided, all fields are returned.

Response

• 200 OK: Successfully retrieved the record.
• 400 Bad Request: Invalid record fields provided.
• 401 Unauthorized: Authentication required.
• 404 Not Found: Record with the provided ID not found.

Response Body

{
  "data": {
    ...record fields
  }
}

Example

Request

NodeJS

curl -X GET \
-H "accept: */*" \
-H "Authorization: ******" \
"https://$ACCOUNT_NAME.juleb.com/api/v1/pos/pos-category/8?fields=id%2Cname%2Cparent_id"

curl

const axios = require('axios');
const accountName = process.env.ACCOUNT_NAME;
const apiKey = process.env.API_KEY;

axios.get(`https://${accountName}.juleb.com/api/v1/pos/pos-category/8`, {
  headers: {
    'accept': '*/*',
    'Authorization': `TOKEN`
  },
  params: {
    fields: 'id,name,parent_id'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

python

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;

public class Main {
    public static void main(String[] args) throws Exception {
        String accountName = System.getenv("ACCOUNT_NAME");
        String apiKey = System.getenv("API_KEY");

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(new URI("https://" + accountName + ".juleb.com/api/v1/pos/pos-category/8?fields=id,name,parent_id"))
            .header("accept", "*/*")
            .header("Authorization", "Bearer " + apiKey)
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
        if (response.statusCode() == 200) {
            System.out.println(response.body());
        } else {
            System.out.println("Error: " + response.statusCode() + ", " + response.body());
        }
    }
}

java

import os
import requests

account_name = os.getenv('ACCOUNT_NAME')
api_key = os.getenv('API_KEY')

url = f'https://{account_name}.juleb.com/api/v1/pos/pos-category/8'
headers = {
    'accept': '*/*',
    'Authorization': f'******'
}
params = {
    'fields': 'id,name,parent_id'
}

response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
    print(response.json())
else:
    print(f'Error: {response.status_code}', response.text)

Response

{
  "data": {
    "id": 8,
    "name": "Pain Relief",
    "parent_id": null
  }
}