{"id":21537,"date":"2021-08-20T15:32:32","date_gmt":"2021-08-20T14:32:32","guid":{"rendered":"https:\/\/bigredcloud.com\/?post_type=docs&#038;p=21537"},"modified":"2022-11-14T13:09:13","modified_gmt":"2022-11-14T13:09:13","password":"","slug":"api-information","status":"publish","type":"docs","link":"https:\/\/bigredcloud.com\/en\/documents\/api-information\/","title":{"rendered":"API Information"},"content":{"rendered":"<p>Click the below button for the API Reference page:<\/p>\n<div class=\"fusion-button-wrapper\">\n<p><a class=\"fusion-button button-flat fusion-button-default-size button-default button-4 fusion-button-default-span fusion-button-default-type\" href=\"https:\/\/app.bigredcloud.com\/api\" target=\"_blank\" rel=\"noopener noreferrer\"><span class=\"fusion-button-text\">API Reference<\/span><\/a><\/p>\n<\/div>\n<p>Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA.<\/p>\n<p>An API access works like a regular Big Red Cloud user: you create a Big Red Cloud account with a company, create an API Key associated with a company and start working with the company via API very similarly to the way you work with our web application.<\/p>\n<p><strong>Getting Started<\/strong><\/p>\n<ol>\n<li>Setup Big Red Cloud account<\/li>\n<li>Start with setting up a free trial or commercial account<br \/>\nB. Create your unique API Key associated with your company<br \/>\n2. Explore API<br \/>\nA. Follow CODE SAMPLES (C#, Java, PHP, Perl, NodeJS) for your favorite language for a fast start<br \/>\nB. Get familiar with Big Red Cloud entities structure available for API<br \/>\nC. Explore every API method available<\/li>\n<li>Integrate your business<br \/>\nA. Use the API to integrate Big Red Cloud with your applications<\/li>\n<\/ol>\n<p><strong>Sandbox<\/strong><\/p>\n<p>Big Red Cloud does not provide a separate company slot within your Tenant\/Subscription for API testing purposes. You are welcome to use Trial Tenant for that purpose.<\/p>\n<p><strong>Authentication<\/strong><\/p>\n<p>Big Red Cloud API uses HTTP Basic Authentication. With this authentication type in each request client have to provide Authorization header which contains a Base-64 encoded username and password. For Big Red Cloud API you need to specify an username as your API key:<\/p>\n<p><em>\u201cAuthorization\u201d: \u201cBasic \u201d + base64_encode(API Key)<\/em><\/p>\n<p>In most libraries, credentials can be specified in the request authentication section. In this case, specify username as your API key and set password to any string.<\/p>\n<p><strong>HTTP Headers<\/strong><\/p>\n<p>CONTENT-TYPE<\/p>\n<p>For POST and PUT requests you have to specify the MIME type of the body of the request. Big Red Cloud API supports only application\/json type:<\/p>\n<p><em>Content-Type: application\/json; charset=utf-8<\/em><\/p>\n<p><strong>HTTP Response Codes<\/strong><\/p>\n<p>Every response from BigRedCloud API includes HTTP status code which describes processing result of the requested operation.<\/p>\n<p>2XX SUCCESS<\/p>\n<p>200 OK<br \/>\nThe request was successful. Used as a response to successful get and batch requests.<\/p>\n<p>201 Created<br \/>\nThe request has been fulfilled and resulted in a new resource being created. Used as a response to a successful create request.<\/p>\n<p>204 No Content<br \/>\nThe server successfully processed the request, but is not returning any content. Used as a response to successful update and delete requests.<\/p>\n<p>4XX CLIENT ERROR<\/p>\n<p>400 Bad Request<br \/>\nThe request cannot be fulfilled due to bad syntax.<\/p>\n<p>401 Unauthorized<br \/>\nAPI key is missing or invalid.<\/p>\n<p>403 Forbidden<br \/>\nThe provided credentials were successfully authenticated but that credentials still do not grant the client permission to access the resource.<\/p>\n<p>404 Not Found<br \/>\nThe requested resource could not be found. In particular, used as a response when get, update or delete requests address to entity that does not exist.<\/p>\n<p>409 Conflict<br \/>\nIndicates that the request could not be processed because of concurrency conflict. Detailed information you can find in the section Handling concurrency &lt; link to section &gt;<\/p>\n<p>422 Unprocessable Entity<br \/>\nIndicates that some business rule violated. See the response body for detailed message.<\/p>\n<p>5XX SERVER ERROR<\/p>\n<p>500 Internal Server Error<br \/>\nThe server encountered an error while processing the request. See the response body for more details.<\/p>\n<p><strong>Concurrency<\/strong><\/p>\n<p>A concurrency conflict occurs when one user gets an entity to edit it, and then another user updates the same entity before the changes of the first user is accepted. If do not use detection of these conflicts, the last update overwrites other user\u2019s changes.<\/p>\n<p>To prevent this accidental data loss Big Red Cloud platform uses optimistic concurrency control: it allows concurrency conflicts to happen, and if they do then react in a proper way. For example, user A gets SalesEntry and changes the Total field. User B gets the same SalesEntry and changes the EntryDate field. Then user A calls service\u2019s update operation for this entity and receives OK response. After that user B calls the same operation for the same entity. In this scenario user B receives a 409 Conflict response code. In this case user B has to get this, changed by user A, entity again, make the changes and call service\u2019s update operation.<\/p>\n<p>In order to implement optimistic concurrency control, each entity (supposes modifications) returns with a field timestamp \u2013 this field managed by Big Red Cloud platform at server-side and you cannot change it. For every update and delete operations you have to provide timestamp received in appropriate GET operation (for update \u2013 in request body, for delete \u2013 in URL).<\/p>\n<p>When you update an entity, the timestamp field re-generated to a new unique value automatically at server side.<\/p>\n<p><strong>ODATA Features<\/strong><\/p>\n<p>This is not an ODATA API. This is REST API still; it supports several features from ODATA when querying data collections. The target collection is specified through a URL, and query operations such as filter, sort, paging, and projection are specified as System Query Options provided as query options. The names of all System Query Options are prefixed with a \u201c$\u201d character.<\/p>\n<p>Please find detailed specification on querying ODATA collections by the link: https:\/\/www.odata.org\/documentation\/odata-v3-documentation\/odata-core\/#1023_Querying_Collections<\/p>\n<p>Limitations<\/p>\n<p>Big Red Cloud API supports following System Query Options:<\/p>\n<p><strong>$filter<\/strong><br \/>\n<strong>$orderby<\/strong><br \/>\n<strong>$top<\/strong><br \/>\n<strong>$skip<\/strong><br \/>\n<strong>$inlinecount<\/strong><br \/>\nOnly logical operators allowed from the set of Built-in Filter Operations.<\/p>\n<p>All Built-in Query Functions are forbidden.<\/p>\n<p>There are number of additional limitations for each specific entity. You can find description of these limitations in documentation for API entities: &lt; link to dynamic documentation tbd &gt;<\/p>\n<p>Pagination<\/p>\n<p>API limits the number of entities that it sends in a single response. The maximum number of entities in response is 100. Entities querying response\u2019s body has following structure:<\/p>\n<p><em>{<br \/>\nCount: (Total number of entities),<br \/>\nItems:<\/em><\/p>\n<p><em>[ (List of entities) ],<br \/>\nNextPageLink: (Link to the next entities\u2019 page)<br \/>\n}<\/em><\/p>\n<p>Count field indicates the total number of available entities. This field contains a value only if $inlinecount System Query Option with a value of allpages was specified in the request URL. Otherwise the Count field is null.<\/p>\n<p>Items field contains a list of entities for the current page.<\/p>\n<p>NextPageLink contains a link to the next page of data. If current page is the last one, the NextPageLink contains null.<\/p>\n<p><strong>Create Operation<\/strong><\/p>\n<p>When the server creates a new entity, it includes the URL of the new resource in the Location header of the response. The template of this URL is:<\/p>\n<p>Location: https:\/\/api.bigredcloud.com\/\/v1\/{Entity set name}\/{Id}<br \/>\nFor example, if you create a new Product, the Location header may have following view:<\/p>\n<p>Location: https:\/\/api.bigredcloud.com\/\/v1\/Products\/8<br \/>\nWhich means that the created Product has identifier 8, and it is available by URL provided.<\/p>\n<p><strong>Batch Operations<\/strong><\/p>\n<p>Big Red Cloud API supports execution of multiple operations in a single request. Following operations are supported: create, update, delete. Only operations with entities of the same type can be grouped in one batch.<\/p>\n<p>Request<\/p>\n<p>The PUT method should be used for batch requests. The body of batch request has the next structure:<\/p>\n<p><em>[<br \/>\n{<br \/>\nitem: { (Information for item 1) },<br \/>\nopCode: (Operation code for item 1)<br \/>\n},<br \/>\n{<br \/>\nitem: { (Information for item 2) },<br \/>\nopCode: (Operation code for item 2)<br \/>\n},<br \/>\n\u2026<br \/>\n]<\/em><\/p>\n<p><strong>Create<\/strong><\/p>\n<p>item contains information about created entity.<\/p>\n<p><em>opCode should be 1<\/em><\/p>\n<p><strong>Update<\/strong><\/p>\n<p>item contains information about updated entity. Fields id and timestamp are mandatory for all entities. Detailed information about timestamp field you can find in the section Handling concurrency &lt; link to section &gt;<\/p>\n<p><em>opCode should be 2<\/em><\/p>\n<p><strong><br \/>\nDelete<\/strong><\/p>\n<p>item has the next structure:<\/p>\n<p><em>{<br \/>\nid: (Id of deleted entity),<br \/>\ntimestamp: (Timestamp of deleted entity)<br \/>\n}<\/em><\/p>\n<p><em>opCode should be 3.<\/em><\/p>\n<p><strong>Response<\/strong><\/p>\n<p>Response contains a list of processing results for each entity in the batch request. Order of the result elements corresponds with the order of entities in the request. I.e. if entity was the third in the request array, result of processing for this entity would be third in the response array.<\/p>\n<p>In spite of any error during processing specific entity, the response status code will be 200 OK. You have to examine the response body to find failed operations.<\/p>\n<p>The body of batch response has following structure:<\/p>\n<p><em>[<br \/>\n{<br \/>\ncode: (HTTP status code for item 1),<br \/>\nid: (Id of created, updated or deleted entity for item 1),<br \/>\nmessage: (Error message for item 1)<br \/>\n},<br \/>\n{<br \/>\ncode: (HTTP status code for item 2),<br \/>\nid: (Id of created, updated or deleted entity for item 2),<br \/>\nmessage: (Error message for item 2)<br \/>\n},<br \/>\n\u2026<br \/>\n]<\/em><\/p>\n<p>code attribute contains HTTP status code which describes result of specific entity processing. Description of status codes you can find in the section HTTP Response Codes.<\/p>\n<p>id attribute contains identifier for processed entity. For update and delete operations this field contains the same value that the field id contained in appropriate request item. For create operations this field contains identifier of newly created entity.<\/p>\n<p>message attribute contains a message of the error occurred during specific entity processing. If there were no errors (code field is 2xx) this field contains null.<\/p>\n<p><strong>Throttling Protection<\/strong><\/p>\n<p>Big Red Cloud API protected from throttling issue by limiting # of API call per API Key per time period.<\/p>\n<p>There is only one limitation \u201cper 1 hour per 1 API Key\u201d equals to 1,000 API calls per 1 hour sliding period.<\/p>\n<p>If you exceed this rate you will receive a HTTP 429 server response error code (too many client requests) with a message \u201cYou have exceeded the permitted number of API calls of 1,000 per hour. Future API calls will be ignored until the beginning of the next period\u201d.<\/p>\n<p>If you need more calls rate than provided, contact Big Red Cloud support team ().<\/p>\n<p><strong>Logical Structure<\/strong><\/p>\n<p>Big Red Cloud API reflects web application UI logical structure: same principle of Books, Book Transactions, Dictionaries, etc.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-21539\" src=\"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png\" alt=\"\" width=\"624\" height=\"695\" srcset=\"https:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png 624w, https:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1-269x300.png 269w\" sizes=\"auto, (max-width: 624px) 100vw, 624px\" \/><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignleft wp-image-21541 size-full\" src=\"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/cash.png\" alt=\"\" width=\"123\" height=\"51\" \/><\/p>\n<p style=\"text-align: left;\">Fake entity \u2013 given for structure only<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-21542 alignleft\" src=\"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/sales.png\" alt=\"\" width=\"123\" height=\"51\" \/><\/p>\n<p style=\"text-align: left;\">Real API entity<\/p>\n<p>&nbsp;<\/p>\n<p style=\"text-align: left;\">Note that purple boxes are fake entries represented for structure only where red boxes are boxes are real API entries.<\/p>\n<p><strong>C#<\/strong><\/p>\n<p>Trivial example<\/p>\n<p>Following is a simple console C# application:<\/p>\n<p>(do not forget to add System.Net.Http assembly as a project reference)<\/p>\n<p><em>using System;<br \/>\nusing System.Net.Http;<br \/>\nusing System.Text;<\/em><\/p>\n<p><em>namespace BigRedBook.Api.SimpleSamples<br \/>\n{<br \/>\nclass Program<br \/>\n{<br \/>\nstatic void Main(string[] args)<br \/>\n{<br \/>\n\/\/ Initialize constants. Change values to suitable for you!<br \/>\nconst string baseApiAddress = \u201chttps:\/\/app.bigredcloud.com\/\/api\/v1\/\u201d;<br \/>\nconst string apiKey = \u201c\u201d;<br \/>\nconst string entitiesName = \u201cProducts\u201d;<\/em><\/p>\n<p><em>\/\/ Create and initialize HttpClient client.<br \/>\nHttpClient client = new HttpClient { BaseAddress = new Uri(baseApiAddress) };<\/em><\/p>\n<p><em>\/\/ Add Authorization header.<br \/>\nbyte[] apiKeyAsBytes = Encoding.ASCII.GetBytes(apiKey);<br \/>\nstring apiKeyBase64Encoded = Convert.ToBase64String(apiKeyAsBytes);<br \/>\nstring authorizationHeaderValue = \u201cBasic \u201d + apiKeyBase64Encoded;<br \/>\nclient.DefaultRequestHeaders.Add(\u201cAuthorization\u201d, authorizationHeaderValue);<\/em><\/p>\n<p><em>\/\/ Make a call to API \u2013 retrieve entity with maximal Id.<br \/>\nconst string odataQueryParameters = \u201c$orderby=id desc&amp;$top=1\u201d;<br \/>\nstring requestUri = String.Format(\u201c{0}?{1}\u201d, entitiesName, odataQueryParameters);<br \/>\nHttpResponseMessage response = client.GetAsync(requestUri).Result;<\/em><\/p>\n<p><em>\/\/ Display result of response.<br \/>\nConsole.WriteLine(\u201cStatus code: {0} {1}\u201d, (int)response.StatusCode, response.StatusCode);<br \/>\nConsole.WriteLine(\u201cContent:\u201d);<br \/>\nstring contentAsString = response.Content.ReadAsStringAsync().Result;<br \/>\nConsole.WriteLine(contentAsString);<\/em><\/p>\n<p><em>Console.Write(\u201cPress any key to continue\u2026\u201d);<br \/>\nConsole.ReadLine();<br \/>\n}<br \/>\n}<br \/>\n}<\/em><\/p>\n<p><strong>Complex example<\/strong><\/p>\n<p>A complex example consists from two parts: a Visual Studio solution with examples and a Visual Studio solution with big red cloud API client library on C#. The client library is an intermediate object-oriented layer for rapid api usage. This is recommended way to work with big red cloud api. The API client library is going to be improved and supported according to future Big Red Cloud API releases.<\/p>\n<p>API Client: https:\/\/github.com\/BigRedCloud\/apiclient-net<\/p>\n<p>API Samples: https:\/\/github.com\/BigRedCloud\/apisamples-net<\/p>\n<p><strong>Java<\/strong><\/p>\n<p>Trivial Example<\/p>\n<p>Following is console java application:<\/p>\n<p>(do not forget to include commons-codec-1.8.jar library as a reference)<\/p>\n<p><em>package bigredbook.api.simplesamples;<\/em><\/p>\n<p><em>import java.io.*;<br \/>\nimport java.net.*;<br \/>\nimport java.util.*;<\/em><\/p>\n<p><em>import org.apache.commons.codec.binary.Base64;<\/em><\/p>\n<p><em>public class Program {<\/em><\/p>\n<p><em>public static void main(String[] args) {<br \/>\n\/\/ Initialize constants. Change values to suitable for you!<br \/>\nfinal String baseApiAddress = \u201chttps:\/\/app.bigredcloud.com\/\/api\/v1\/\u201d;<br \/>\nfinal String apiKey = \u201c\u201d;<br \/>\nfinal String entitiesName = \u201cproducts\u201d;<\/em><\/p>\n<p><em>HttpURLConnection client = null;<br \/>\nStringBuilder result = null;<br \/>\nInteger statusCode = null;<br \/>\nString statusMessage = null;<\/em><\/p>\n<p><em>try {<br \/>\n\/\/ Make a call to API \u2013 retrieve entity with maximal Id.<br \/>\nfinal String odataQueryParameters = \u201c$orderby=id desc&amp;$top=1\u201d;<br \/>\nString requestUri = baseApiAddress + \u2018\/\u2019<br \/>\n+ String.format(\u201c%1$s?%2$s\u201d, entitiesName, odataQueryParameters);<br \/>\n\/\/ Create and initialize HttpClient client.<br \/>\nURI uri = new URI(requestUri.replace(\u201d \u201c, \u201c%20\u201d));<br \/>\nURL url = uri.toURL();<br \/>\nclient = (HttpURLConnection) url.openConnection();<br \/>\n\/\/ Add Authorization header.<br \/>\nbyte[] apiKeyAsBytes = apiKey.getBytes(\u201cASCII\u201d);<br \/>\nString apiKeyBase64Encoded = Base64.encodeBase64URLSafeString(apiKeyAsBytes);<br \/>\nString authorizationHeaderValue = \u201cBasic \u201d + apiKeyBase64Encoded;<br \/>\nclient.setRequestProperty(\u201cAuthorization\u201d, authorizationHeaderValue);<br \/>\nclient.setRequestMethod(\u201cGET\u201d);<br \/>\nclient.connect();<\/em><\/p>\n<p><em>statusCode = client.getResponseCode();<br \/>\nstatusMessage = client.getResponseMessage();<br \/>\nBufferedReader rd = new BufferedReader(new InputStreamReader(client.getInputStream()));<br \/>\nresult = new StringBuilder();<br \/>\nString line = null;<br \/>\nwhile ((line = rd.readLine()) != null) {<br \/>\nresult.append(line + \u2018n\u2019);<br \/>\n}<br \/>\n} catch (URISyntaxException e) {<br \/>\ne.printStackTrace();<br \/>\n} catch (MalformedURLException e) {<br \/>\ne.printStackTrace();<br \/>\n} catch (ProtocolException e) {<br \/>\ne.printStackTrace();<br \/>\n} catch (IOException e) {<br \/>\ne.printStackTrace();<br \/>\n} finally{<br \/>\n\/\/close the connection<br \/>\nif(client != null) {<br \/>\nclient.disconnect();<br \/>\n}<br \/>\n}<br \/>\n\/\/ Display result of response.<br \/>\nSystem.out.printf(\u201cStatus code: %1$s %2$s\u201d + \u201crn\u201d, statusCode, statusMessage);<br \/>\nSystem.out.println(\u201cContent:\u201d);<br \/>\nString contentAsString = result.toString();<br \/>\nSystem.out.println(contentAsString);<br \/>\nSystem.out.print(\u201cPress any key to continue . . .\u201d);<br \/>\nnew Scanner(System.in).nextLine();<br \/>\n}<br \/>\n}<\/em><\/p>\n<p><strong>PHP<\/strong><\/p>\n<p>Trivial Example<\/p>\n<p><em>class ApiClass {<\/em><\/p>\n<p><em>\/\/ Initialize constants. Change values to suitable for you!<br \/>\nconst BASE_API_ADDRESS = \u201chttps:\/\/app.bigredcloud.com\/\/api\/v1\/\u201d;<br \/>\nconst API_KEY = \u201c\u201d;<br \/>\nconst ENTITIES_NAME = \u201cProducts\u201d;<br \/>\nconst QUERY_PARAMETERS = \u2018$orderby=id+desc&amp;$top=1\u2019;<\/em><\/p>\n<p><em>public function requestApi()<br \/>\n{<br \/>\n\/\/check for installed curl extension<br \/>\nif (!function_exists(\u2018curl_init\u2019)) {<br \/>\nthrow new Exception(\u2018CURL is not installed!\u2019);<br \/>\n}<\/em><\/p>\n<p><em>\/\/ Set authorization header.<br \/>\n$apiKeyBase64Encoded = base64_encode(API_KEY);<br \/>\n$authorizationHeaderValue = \u201cBasic \u201d + $apiKeyBase64Encoded;<br \/>\n$requestUri = ENTITIES_NAME.\u2019?\u2019.QUERY_PARAMETERS;<\/em><\/p>\n<p><em>\/\/init connection<br \/>\n$ch = curl_init(BASE_API_ADDRESS.$requestUri);<br \/>\ncurl_setopt($ch, CURLOPT_HTTPHEADER, array(\u2018Authorization \u2018.$authorizationHeaderValue));<\/em><\/p>\n<p><em>$opts = array(<br \/>\nCURLOPT_RETURNTRANSFER =&gt; 1,<br \/>\nCURLOPT_TIMEOUT =&gt; 120,<br \/>\nCURLOPT_FAILONERROR =&gt; 1<br \/>\n);<\/em><\/p>\n<p><em>curl_setopt_array($ch, $opts);<br \/>\n$response = curl_exec($ch);<br \/>\ncurl_close($ch);<\/em><\/p>\n<p><em>return $response;<br \/>\n}<br \/>\n}<\/em><\/p>\n<p><strong>NodeJS<\/strong><\/p>\n<p>Trivial Example<\/p>\n<p><em>var http = require(\u2018https\u2019);<br \/>\nvar BASE_API_ADDRESS = \u201chttps:\/\/app.bigredcloud.com\/\u201d;<br \/>\nvar BASE_API_HOST = \u201capp.bigredcloud.com\/\u201d;<br \/>\nvar API_KEY = \u201c\u201d;<br \/>\nvar ENTITIES_NAME = \u201cProducts\u201d;<br \/>\nvar QUERY_PARAMETERS = \u2018$orderby=id+desc&amp;$top=1\u2019;<\/em><\/p>\n<p><em>var authorizationHeaderValue = new Buffer(API_KEY, \u2018base64\u2019);<\/em><\/p>\n<p><em>var optionsget = {<br \/>\nhost : BASE_API_HOST, \/\/ here only the domain name<br \/>\nport : 443,<br \/>\npath : \u2018\/api\/v1\/\u2019 + ENTITIES_NAME + QUERY_PARAMETERS, \/\/ the rest of the url with parameters if needed<br \/>\nmethod : \u2018GET\u2019, \/\/ do GET<br \/>\nheaders: { \u2018Authorization\u2019: authorizationHeaderValue }<br \/>\n};<\/em><\/p>\n<p><em>console.info(\u2018Options prepared:\u2019);<br \/>\nconsole.info(optionsget);<br \/>\nconsole.info(\u2018Do the GET call\u2019);<\/em><\/p>\n<p><em>\/\/ do the GET request<br \/>\nvar reqGet = http.request(optionsget, function(res) {<br \/>\n\/\/console.log(\u201cstatusCode: \u201c, res.statusCode);<br \/>\n\/\/ uncomment this for header details<br \/>\n\/\/ console.log(\u201cheaders: \u201c, res.headers);<\/em><\/p>\n<p><em>res.on(\u2018data\u2019, function(d) {<br \/>\nconsole.info(\u2018GET result:n\u2019);<br \/>\nprocess.stdout.write(d);<br \/>\nconsole.info(\u2018nnCall completed\u2019);<br \/>\n});<br \/>\n});<br \/>\nreqGet.end();<br \/>\nreqGet.on(\u2018error\u2019, function(e) {<br \/>\nconsole.error(e);<br \/>\n});<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of&#8230;<\/p>\n","protected":false},"author":19,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"footnotes":""},"doc_category":[229],"doc_tag":[],"class_list":{"0":"post-21537","1":"docs","2":"type-docs","3":"status-publish","5":"doc_category-administration-features"},"year_month":"2026-04","word_count":2368,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"apathak","author_nicename":"apathak","author_url":"https:\/\/bigredcloud.com\/en\/author\/apathak\/"},"doc_category_info":[{"term_name":"Administration Features","term_url":"https:\/\/bigredcloud.com\/en\/docs-category\/administration-features\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.3 (Yoast SEO v27.4) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>API Information - Big Red Cloud<\/title>\n<meta name=\"description\" content=\"Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA. An API\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/bigredcloud.com\/documents\/api-information\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Information\" \/>\n<meta property=\"og:description\" content=\"Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA. An API\" \/>\n<meta property=\"og:url\" content=\"https:\/\/bigredcloud.com\/documents\/api-information\/\" \/>\n<meta property=\"og:site_name\" content=\"Big Red Cloud\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/SimpleOnlineAccounts\" \/>\n<meta property=\"article:modified_time\" content=\"2022-11-14T13:09:13+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@BigRedCloud\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"11 minutes\" \/>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"API Information - Big Red Cloud","description":"Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA. An API","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/bigredcloud.com\/documents\/api-information\/","og_locale":"en_US","og_type":"article","og_title":"API Information","og_description":"Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA. An API","og_url":"https:\/\/bigredcloud.com\/documents\/api-information\/","og_site_name":"Big Red Cloud","article_publisher":"https:\/\/www.facebook.com\/SimpleOnlineAccounts","article_modified_time":"2022-11-14T13:09:13+00:00","og_image":[{"url":"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_site":"@BigRedCloud","twitter_misc":{"Est. reading time":"11 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/bigredcloud.com\/documents\/api-information\/","url":"https:\/\/bigredcloud.com\/documents\/api-information\/","name":"API Information - Big Red Cloud","isPartOf":{"@id":"https:\/\/bigredcloud.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/bigredcloud.com\/documents\/api-information\/#primaryimage"},"image":{"@id":"https:\/\/bigredcloud.com\/documents\/api-information\/#primaryimage"},"thumbnailUrl":"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png","datePublished":"2021-08-20T14:32:32+00:00","dateModified":"2022-11-14T13:09:13+00:00","description":"Click the below button for the API Reference page: API Reference Big Red Cloud\u2019s Public API provides two kinds of API: (1) REST and (2) ODATA. An API","breadcrumb":{"@id":"https:\/\/bigredcloud.com\/documents\/api-information\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/bigredcloud.com\/documents\/api-information\/"]}]},{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/bigredcloud.com\/documents\/api-information\/#primaryimage","url":"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png","contentUrl":"http:\/\/bigredcloud.com\/wp-content\/uploads\/2021\/08\/api-1.png"},{"@type":"BreadcrumbList","@id":"https:\/\/bigredcloud.com\/documents\/api-information\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/bigredcloud.com\/en\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/bigredcloud.com\/en\/documents\/"},{"@type":"ListItem","position":3,"name":"API Information"}]},{"@type":"WebSite","@id":"https:\/\/bigredcloud.com\/#website","url":"https:\/\/bigredcloud.com\/","name":"Big Red Cloud","description":"Online Accounting Software","publisher":{"@id":"https:\/\/bigredcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/bigredcloud.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/bigredcloud.com\/#organization","name":"Big Red Cloud","url":"https:\/\/bigredcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/bigredcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/bigredcloud.com\/wp-content\/uploads\/2025\/07\/unnamed-1.png","contentUrl":"https:\/\/bigredcloud.com\/wp-content\/uploads\/2025\/07\/unnamed-1.png","width":512,"height":512,"caption":"Big Red Cloud"},"image":{"@id":"https:\/\/bigredcloud.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/SimpleOnlineAccounts","https:\/\/x.com\/BigRedCloud","https:\/\/www.linkedin.com\/company\/big-red-cloud\/?originalSubdomain=ie"]}]}},"_links":{"self":[{"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/docs\/21537","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/users\/19"}],"replies":[{"embeddable":true,"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/comments?post=21537"}],"version-history":[{"count":0,"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/docs\/21537\/revisions"}],"wp:attachment":[{"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/media?parent=21537"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/doc_category?post=21537"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/bigredcloud.com\/en\/wp-json\/wp\/v2\/doc_tag?post=21537"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}