# Data Returned - Limits

**URL:** <http://forum.companieshouse.gov.uk/t/data-returned-limits/428>\
**Category:** Information\
**Created:** [January 29, 2016, 3:57pm UTC](http://forum.companieshouse.gov.uk/t/data-returned-limits/428 "2016-01-29T15:57:18Z")\
**Posts on this page:** 1\
**Showing post:** 6

<div class="post-metadata">

**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\
**Post date:** [February 9, 2016, 2:57pm UTC](http://forum.companieshouse.gov.uk/t/data-returned-limits/428/6 "2016-02-09T14:57:29Z")

</div>

@edith_manyumwa

The data dictionary for the API is published for each endpoint within the documentation: - [https://developer.companieshouse.gov.uk/api/docs/](https://developer.companieshouse.gov.uk/api/docs/)

For each resource returned we provide the following: -

_ **Parameter Name:** _ The name of the field  
_ **Type:** _ The data type  
_ **Description:** _ A brief description   
_ **Additional:** _ Details if its optional

We haven’t published field lengths as we are discussing if todo so and the most appropriate method. The reasoning behind being so reserved is we do not want to restrict ourselves and others with specific field lengths as changing in the future could be classed as a breaking change to the API and we want to limit breaking changes.

However to provide some information, the following details the maximum field lengths, at present, for the specific fields requested, but this may change in the future, so use for guidance, so maybe use double these values 😀 This should not be treated as official documentation as we have stated we are currently in the process of evaluating.

```
address" : {
       "address_line_1" : "string", 64 characters
       "address_line_2" : "string", 64 characters
       "care_of" : "string", 100 characters
       "country" : "string", 50 characters
       "locality" : "string", 50 characters
       "po_box" : "string", 10 characters
       "postal_code" : "string", 15 characters
       "premises" : "string", 50 characters
       "region" : "string" 50 characters

"name_elements" : {
        "forename" : "string", 50 characters
        "honours" : "string", 50 characters
        "other_forenames" : "string", 50 characters
        "surname" : "string", 160 characters
        "title" : "string" 50 characters

```

Hope this is of help

Thanks

@mfairhurst

---

_[View the full topic](http://forum.companieshouse.gov.uk/t/data-returned-limits/428)._