Skip to main content

Postman Collection

Import the Qarta API Postman collection to quickly test all 36 API endpoints.

Download Collection​

The collection is available as an exported JSON file that you can import directly into Postman.

Download Qarta Collection (JSON)

How to Import​

Step 1: Download the Collection​

Click the download link above to save the qarta.json file to your computer.

Step 2: Import into Postman​

Option A: Import File

  1. Open Postman
  2. Click File → Import (or click Import button in top-left)
  3. Select Upload Files tab
  4. Choose the qarta.json file you downloaded
  5. Click Import

Option B: Import Folder

  1. Open Postman
  2. Click File → Import
  3. Drag and drop the qarta.json file into the import dialog
  4. Click Import

Configure Your API Key​

Once imported, you'll need to set up your API key:

  1. In Postman, click Environments (bottom left)

  2. Click Create New Environment

  3. Name it: Qarta

  4. Add these variables:

    • Key: api_key | Value: YOUR_QARTA_API_KEY_HERE
    • Key: base_url | Value: https://graph.quarticle.ro

  5. Click Save

  6. In the top-right, select your Qarta environment from the dropdown

Now all requests will automatically use your API key through {{api_key}} and base URL through {{base_url}}.

Method 2: Manual Header Setup​

If not using environment variables:

  1. In each request, go to the Headers tab
  2. Find the Authorization header
  3. Change the value from YOUR_API_KEY to YOUR_ACTUAL_API_KEY

Test a Request​

  1. Select any endpoint from the collection (e.g., GET /graph/api/v1/places/geocode)
  2. Click Send
  3. You should see the API response

If you get a 401 Unauthorized error:

  • Verify your API key is correct
  • Check that you've selected the correct environment (if using variables)
  • Make sure the Authorization header is properly set

Collection Contents​

This collection includes all 36 endpoints for Qarta, organized by functional area:

Location Services (3 endpoints)​

  • Address Autocomplete - GET /graph/api/v1/places/autocomplete
  • Geocode Address - GET /graph/api/v1/places/geocode
  • Reverse Geocode - GET /graph/api/v1/places/geocode/reverse

Portfolio Analysis V1 (12 endpoints)​

  • Get Provision - GET /graph/api/v1/reports/portfolio/provision
  • Get Provision Filters - GET /graph/api/v1/reports/portfolio/provision/filters
  • Get Points - POST /graph/api/v1/reports/portfolio/points/selection
  • Get Points in Buffer - POST /graph/api/v1/reports/portfolio/points/buffer-selection
  • Get Entries - POST /graph/api/v1/reports/portfolio/entries/selection
  • Get Entries in Buffer - POST /graph/api/v1/reports/portfolio/entries/buffer-selection
  • Search Entries - GET /graph/api/v1/reports/portfolio/entries/selection/search
  • Get Point Attributes - GET /graph/api/v1/reports/portfolio/points/attributes
  • Accumulate Data - POST /graph/api/v1/reports/portfolio/accumulation/selection
  • Accumulate in Buffer - POST /graph/api/v1/reports/portfolio/accumulation/buffer
  • Get Layer Data - POST /graph/api/v1/reports/portfolio/accumulation/layer
  • Get Risk Report - POST /graph/api/v1/reports/risk/point

Portfolio Analysis V2 (10 endpoints)​

  • V2 Get Points - POST /graph/api/v2/reports/portfolio/points/selection
  • V2 Get Points in Buffer - POST /graph/api/v2/reports/portfolio/points/buffer-selection
  • V2 Get Entries - POST /graph/api/v2/reports/portfolio/entries/selection
  • V2 Get Entries in Buffer - POST /graph/api/v2/reports/portfolio/entries/buffer-selection
  • V2 Search Entries - POST /graph/api/v2/reports/portfolio/entries/selection/search
  • V2 Accumulate Data - POST /graph/api/v2/reports/portfolio/accumulation/selection
  • V2 Accumulate in Buffer - POST /graph/api/v2/reports/portfolio/accumulation/buffer
  • V2 Get Risk Report - POST /graph/api/v2/reports/risk/point
  • V2 Get Buffer Risk Report - POST /graph/api/v2/reports/portfolio/risk/point-buffer
  • V2 Get Point Risk Report - POST /graph/api/v1/reports/portfolio/risk/point-buffer

Point Enrichment (2 endpoints)​

  • Enrich Single Point - GET /graph/featureinfo/risk-lookup/api/v1/bfi/single
  • Batch Enrich Points - POST /graph/featureinfo/enrichment/api/v1/bfi/batch

Web Services (6 endpoints)​

  • WMS Get Capabilities - GET /graph/layers/wms/GetCapabilities
  • WMS Describe Layer - GET /graph/layers/wms/DescribeLayer
  • WMS Get Map - GET /graph/layers/wms/GetMap
  • WMS Get Feature Info - GET /graph/layers/wms/GetFeatureInfo
  • WMS Get Legend Graphic - GET /graph/layers/wms/GetLegendGraphic
  • WFS Get Feature - GET /graph/layers/wfs/GetFeature

Live Events (1 endpoint)​

  • Enrich Live Event Entries - POST /graph/api/v1/live-events/footprints/:footprint/enrich/entries

Tips & Tricks​

Using Pre-request Scripts​

To automatically set headers or tokens before each request:

  1. Open a request
  2. Go to the Pre-request Script tab
  3. Add JavaScript code to run before the request

Example: Set API key from environment variable

pm.request.headers.add({
  key: 'Authorization',
  value: `${pm.environment.get('api_key')}`
});

Using Tests​

To validate responses:

  1. Open a request
  2. Go to the Tests tab
  3. Add JavaScript code to run after the request

Example: Check status code is 200

pm.test('Status code is 200', function() {
  pm.response.to.have.status(200);
});

Saving Responses​

Click the Save Response button to save the response as an example for that endpoint.

Exporting Data​

To export test data or responses:

  1. Right-click the collection
  2. Select Export
  3. Choose format (JSON or OpenAPI)

Troubleshooting​

Collection won't import​

  • Make sure the JSON file isn't corrupted
  • Try re-downloading the collection
  • Check that Postman is up to date

Requests fail with 401​

  • Verify your API key is valid
  • Check it hasn't expired in your Quarticle dashboard
  • Ensure the Authorization header includes your API key

Requests fail with 404​

  • Check the base URL is correct (should be https://graph.quarticle.ro)
  • Verify the endpoint path matches the collection
  • Check your source parameter (portfolio name) if using portfolio endpoints

Requests fail with 403 (Forbidden)​

  • You may lack access to certain data sources
  • Check your API key has the necessary permissions
  • Verify your organization has access to the requested portfolio

Learn More​

Next Steps​