Veracity Services API

API change history

The Veracity Services API provides information about the currently logged in user (my) and your application in general (this). To call these APIs you need to have an access token for the current user as well as a subscription key. The former can be retrieved once a user authenticates with your application while the latter can be found in the Veracity for Developers resource portal. Head over to https://developer.veracity.com/projects and create an Application resource there to create a subscription key for your application. You can read more about how to authenticate users from your application in the Identity documentation.

Grouping

The API is grouped into 3 distinct sections, each with their own intent.

  • My: Return information about the currently logged in used as defined by their access token.
  • This: Return information about your application.
  • Options: These endpoints are for maintenance purposes. Do not use.

As the API requires the use of an access token unique to a user many of the endpoints will include information specific to that user. E.g.: the /my/profile endpoint will return profile information for that user without any additional query parameters as the users is identified by their access token.

Multiple root urls

The API is versioned in order to provide a consistent contract for your application to call. You can decide yourself if you want to use one or the other. The APIs describe on this page will always be the latest version.

  • https://api.veracity.com/veracity/services/v3

Veracity commits to actively support the latest version of the API as well as the next previous version. This currently means v3 and v2 of the Veracity Services API.

CompaniesDirectory_CompanyById

Get the detailed company description

Try it

Request

Request URL

Request parameters

  • string

Request headers

  • (optional)
    string

    Provide a correlation token for log lookup. This is optional.

  • (optional)
    string

    Veracity api management subscription key

  • string
    Subscription key which provides access to this API. Found in your Profile.
  • string
    OAuth 2.0 access token obtained from B2C PROD OAuth - v2 endpoint. Supported grant types: Authorization code.

Request body

Responses

200 OK

OK

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "name": "string",
  "url": "string",
  "usersUrl": "string",
  "addressLines": [
    "string"
  ],
  "id": "string",
  "city": "string",
  "country": "string",
  "customerId": "string",
  "countryCode": "string",
  "zipCode": "string",
  "#employee": 0,
  "domains": "string",
  "email": "string",
  "#requests": 0,
  "internalId": "string",
  "vat": "string"
}
{
  "required": [
    "#employee",
    "#requests"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-nullable": true
    },
    "url": {
      "type": "string",
      "x-nullable": true
    },
    "usersUrl": {
      "type": "string",
      "x-nullable": true
    },
    "addressLines": {
      "type": "array",
      "items": {
        "type": "string",
        "x-nullable": true
      },
      "x-nullable": true
    },
    "id": {
      "type": "string",
      "x-nullable": true
    },
    "city": {
      "type": "string",
      "x-nullable": true
    },
    "country": {
      "type": "string",
      "x-nullable": true
    },
    "customerId": {
      "type": "string",
      "x-nullable": true
    },
    "countryCode": {
      "type": "string",
      "x-nullable": true
    },
    "zipCode": {
      "type": "string",
      "x-nullable": true
    },
    "#employee": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "domains": {
      "type": "string",
      "x-nullable": true
    },
    "email": {
      "type": "string",
      "x-nullable": true
    },
    "#requests": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "internalId": {
      "type": "string",
      "x-nullable": true
    },
    "vat": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "name": "string",
  "url": "string",
  "usersUrl": "string",
  "addressLines": [
    "string"
  ],
  "id": "string",
  "city": "string",
  "country": "string",
  "customerId": "string",
  "countryCode": "string",
  "zipCode": "string",
  "#employee": 0,
  "domains": "string",
  "email": "string",
  "#requests": 0,
  "internalId": "string",
  "vat": "string"
}
{
  "required": [
    "#employee",
    "#requests"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-nullable": true
    },
    "url": {
      "type": "string",
      "x-nullable": true
    },
    "usersUrl": {
      "type": "string",
      "x-nullable": true
    },
    "addressLines": {
      "type": "array",
      "items": {
        "type": "string",
        "x-nullable": true
      },
      "x-nullable": true
    },
    "id": {
      "type": "string",
      "x-nullable": true
    },
    "city": {
      "type": "string",
      "x-nullable": true
    },
    "country": {
      "type": "string",
      "x-nullable": true
    },
    "customerId": {
      "type": "string",
      "x-nullable": true
    },
    "countryCode": {
      "type": "string",
      "x-nullable": true
    },
    "zipCode": {
      "type": "string",
      "x-nullable": true
    },
    "#employee": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "domains": {
      "type": "string",
      "x-nullable": true
    },
    "email": {
      "type": "string",
      "x-nullable": true
    },
    "#requests": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "internalId": {
      "type": "string",
      "x-nullable": true
    },
    "vat": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<CompanyInfo>
  <name>string</name>
  <url>string</url>
  <usersUrl>string</usersUrl>
  <addressLines>string</addressLines>
  <id>string</id>
  <city>string</city>
  <country>string</country>
  <customerId>string</customerId>
  <countryCode>string</countryCode>
  <zipCode>string</zipCode>
  <_x0023_employee>0</_x0023_employee>
  <domains>string</domains>
  <email>string</email>
  <_x0023_requests>0</_x0023_requests>
  <internalId>string</internalId>
  <vat>string</vat>
</CompanyInfo>
{
  "required": [
    "#employee",
    "#requests"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-nullable": true
    },
    "url": {
      "type": "string",
      "x-nullable": true
    },
    "usersUrl": {
      "type": "string",
      "x-nullable": true
    },
    "addressLines": {
      "type": "array",
      "items": {
        "type": "string",
        "x-nullable": true
      },
      "x-nullable": true
    },
    "id": {
      "type": "string",
      "x-nullable": true
    },
    "city": {
      "type": "string",
      "x-nullable": true
    },
    "country": {
      "type": "string",
      "x-nullable": true
    },
    "customerId": {
      "type": "string",
      "x-nullable": true
    },
    "countryCode": {
      "type": "string",
      "x-nullable": true
    },
    "zipCode": {
      "type": "string",
      "x-nullable": true
    },
    "#employee": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "domains": {
      "type": "string",
      "x-nullable": true
    },
    "email": {
      "type": "string",
      "x-nullable": true
    },
    "#requests": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "internalId": {
      "type": "string",
      "x-nullable": true
    },
    "vat": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<CompanyInfo>
  <name>string</name>
  <url>string</url>
  <usersUrl>string</usersUrl>
  <addressLines>string</addressLines>
  <id>string</id>
  <city>string</city>
  <country>string</country>
  <customerId>string</customerId>
  <countryCode>string</countryCode>
  <zipCode>string</zipCode>
  <_x0023_employee>0</_x0023_employee>
  <domains>string</domains>
  <email>string</email>
  <_x0023_requests>0</_x0023_requests>
  <internalId>string</internalId>
  <vat>string</vat>
</CompanyInfo>
{
  "required": [
    "#employee",
    "#requests"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-nullable": true
    },
    "url": {
      "type": "string",
      "x-nullable": true
    },
    "usersUrl": {
      "type": "string",
      "x-nullable": true
    },
    "addressLines": {
      "type": "array",
      "items": {
        "type": "string",
        "x-nullable": true
      },
      "x-nullable": true
    },
    "id": {
      "type": "string",
      "x-nullable": true
    },
    "city": {
      "type": "string",
      "x-nullable": true
    },
    "country": {
      "type": "string",
      "x-nullable": true
    },
    "customerId": {
      "type": "string",
      "x-nullable": true
    },
    "countryCode": {
      "type": "string",
      "x-nullable": true
    },
    "zipCode": {
      "type": "string",
      "x-nullable": true
    },
    "#employee": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "domains": {
      "type": "string",
      "x-nullable": true
    },
    "email": {
      "type": "string",
      "x-nullable": true
    },
    "#requests": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "internalId": {
      "type": "string",
      "x-nullable": true
    },
    "vat": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

400 Bad Request

Bad request

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

500 Internal Server Error

Unexpected error

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

502 Bad Gateway

Dependency call failure

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

404 Not Found

Not found

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "message": "string",
  "information": "string",
  "subCode": 0,
  "supportCode": "string"
}
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<ErrorDetail>
  <message>string</message>
  <information>string</information>
  <subCode>0</subCode>
  <supportCode>string</supportCode>
</ErrorDetail>
{
  "required": [
    "subCode"
  ],
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "x-nullable": true
    },
    "information": {
      "type": "string",
      "x-nullable": true
    },
    "subCode": {
      "format": "int32",
      "type": "integer",
      "x-nullable": false
    },
    "supportCode": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

403 Forbidden

Forbidden

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "Message": "string"
}
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "Message": "string"
}
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<AuthError>
  <Message>string</Message>
</AuthError>
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<AuthError>
  <Message>string</Message>
</AuthError>
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

401 Unauthorized

Unauthorized

Response headers

  • (optional)
    string

    correlation token for log lookup.

Representations

{
  "Message": "string"
}
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
{
  "Message": "string"
}
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<AuthError>
  <Message>string</Message>
</AuthError>
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}
<AuthError>
  <Message>string</Message>
</AuthError>
{
  "type": "object",
  "properties": {
    "Message": {
      "type": "string",
      "x-nullable": true
    }
  },
  "x-nullable": true
}

Code samples

@ECHO OFF

curl -v -X GET "https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}"
-H "x-supportCode: "
-H "Ocp-Apim-Subscription-Key: "
-H "Ocp-Apim-Subscription-Key: {subscription key}"
-H "Authorization: {access token}"

--data-ascii "{body}" 

using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;

namespace CSHttpClientSample
{
    static class Program
    {
        static void Main()
        {
            MakeRequest();
            Console.WriteLine("Hit ENTER to exit...");
            Console.ReadLine();
        }
        
        static async void MakeRequest()
        {
            var client = new HttpClient();
            var queryString = HttpUtility.ParseQueryString(string.Empty);

            // Request headers
            client.DefaultRequestHeaders.Add("x-supportCode", "");
            client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "");
            client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "{subscription key}");
            client.DefaultRequestHeaders.Add("Authorization", "{access token}");

            var uri = "https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}?" + queryString;

            var response = await client.GetAsync(uri);
        }
    }
}	
// // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class JavaSample 
{
    public static void main(String[] args) 
    {
        HttpClient httpclient = HttpClients.createDefault();

        try
        {
            URIBuilder builder = new URIBuilder("https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}");


            URI uri = builder.build();
            HttpGet request = new HttpGet(uri);
            request.setHeader("x-supportCode", "");
            request.setHeader("Ocp-Apim-Subscription-Key", "");
            request.setHeader("Ocp-Apim-Subscription-Key", "{subscription key}");
            request.setHeader("Authorization", "{access token}");


            // Request body
            StringEntity reqEntity = new StringEntity("{body}");
            request.setEntity(reqEntity);

            HttpResponse response = httpclient.execute(request);
            HttpEntity entity = response.getEntity();

            if (entity != null) 
            {
                System.out.println(EntityUtils.toString(entity));
            }
        }
        catch (Exception e)
        {
            System.out.println(e.getMessage());
        }
    }
}


<!DOCTYPE html>
<html>
<head>
    <title>JSSample</title>
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
</head>
<body>

<script type="text/javascript">
    $(function() {
        var params = {
            // Request parameters
        };
      
        $.ajax({
            url: "https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}?" + $.param(params),
            beforeSend: function(xhrObj){
                // Request headers
                xhrObj.setRequestHeader("x-supportCode","");
                xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key","");
                xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key","{subscription key}");
                xhrObj.setRequestHeader("Authorization","{access token}");
            },
            type: "GET",
            // Request body
            data: "{body}",
        })
        .done(function(data) {
            alert("success");
        })
        .fail(function() {
            alert("error");
        });
    });
</script>
</body>
</html>

#import <Foundation/Foundation.h>

int main(int argc, const char * argv[])
{
    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
    
    NSString* path = @"https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}";
    NSArray* array = @[
                         // Request parameters
                         @"entities=true",
                      ];
    
    NSString* string = [array componentsJoinedByString:@"&"];
    path = [path stringByAppendingFormat:@"?%@", string];

    NSLog(@"%@", path);

    NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
    [_request setHTTPMethod:@"GET"];
    // Request headers
    [_request setValue:@"" forHTTPHeaderField:@"x-supportCode"];
    [_request setValue:@"" forHTTPHeaderField:@"Ocp-Apim-Subscription-Key"];
    [_request setValue:@"{subscription key}" forHTTPHeaderField:@"Ocp-Apim-Subscription-Key"];
    [_request setValue:@"{access token}" forHTTPHeaderField:@"Authorization"];
    // Request body
    [_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
    
    NSURLResponse *response = nil;
    NSError *error = nil;
    NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];

    if (nil != error)
    {
        NSLog(@"Error: %@", error);
    }
    else
    {
        NSError* error = nil;
        NSMutableDictionary* json = nil;
        NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
        NSLog(@"%@", dataString);
        
        if (nil != _connectionData)
        {
            json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
        }
        
        if (error || !json)
        {
            NSLog(@"Could not parse loaded json with error:%@", error);
        }
        
        NSLog(@"%@", json);
        _connectionData = nil;
    }
    
    [pool drain];

    return 0;
}

<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';

$request = new Http_Request2('https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}');
$url = $request->getUrl();

$headers = array(
    // Request headers
    'x-supportCode' => '',
    'Ocp-Apim-Subscription-Key' => '',
    'Ocp-Apim-Subscription-Key' => '{subscription key}',
    'Authorization' => '{access token}',
);

$request->setHeader($headers);

$parameters = array(
    // Request parameters
);

$url->setQueryVariables($parameters);

$request->setMethod(HTTP_Request2::METHOD_GET);

// Request body
$request->setBody("{body}");

try
{
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex)
{
    echo $ex;
}

?>
########### Python 2.7 #############
import httplib, urllib, base64

headers = {
    # Request headers
    'x-supportCode': '',
    'Ocp-Apim-Subscription-Key': '',
    'Ocp-Apim-Subscription-Key': '{subscription key}',
    'Authorization': '{access token}',
}

params = urllib.urlencode({
})

try:
    conn = httplib.HTTPSConnection('api.veracity.com')
    conn.request("GET", "/Veracity/Services/V3/directory/companies/{id}?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################

########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64

headers = {
    # Request headers
    'x-supportCode': '',
    'Ocp-Apim-Subscription-Key': '',
    'Ocp-Apim-Subscription-Key': '{subscription key}',
    'Authorization': '{access token}',
}

params = urllib.parse.urlencode({
})

try:
    conn = http.client.HTTPSConnection('api.veracity.com')
    conn.request("GET", "/Veracity/Services/V3/directory/companies/{id}?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################
require 'net/http'

uri = URI('https://api.veracity.com/Veracity/Services/V3/directory/companies/{id}')


request = Net::HTTP::Get.new(uri.request_uri)
# Request headers
request['x-supportCode'] = ''
# Request headers
request['Ocp-Apim-Subscription-Key'] = ''
# Request headers
request['Ocp-Apim-Subscription-Key'] = '{subscription key}'
# Request headers
request['Authorization'] = '{access token}'
# Request body
request.body = "{body}"

response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(request)
end

puts response.body