# Persons

A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.

A person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.

A person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.

## Get a list of persons

> Return a list of available persons

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"persongender":{"name":"gender","description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","schema":{"type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameFamilyLatinStartsWith":{"name":"nameFamilyLatinStartsWith","description":"Family latin name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFamilyLocalStartsWith":{"name":"nameFamilyLocalStartsWith","description":"Family local name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatin":{"name":"nameFullLatin","description":"The full name of the person in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatinContains":{"name":"nameFullLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameFullLatinContains=Dav will match nameFullLatinContains=John will match nameFullLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameFullLocal":{"name":"nameFullLocal","description":"The full name of the person","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nationality":{"name":"nationality","description":"A 3 letter nationality code","schema":{"type":"string","minLength":3,"maxLength":3},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"personIds":{"name":"personIds","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"representing":{"name":"representing","description":"Who the person was representing","schema":{"type":"string","maxLength":100},"required":false,"in":"query"},"representingCountry":{"name":"representingCountry","description":"What country representation is used\n>- `ANY` Any country\n>- `NONE` No country\n","schema":{"type":"string","enum":["NONE","ANY"]},"required":false,"in":"query"},"personstatus":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","schema":{"type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"]},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons":{"get":{"tags":["Persons"],"summary":"Get a list of persons","description":"Return a list of available persons","operationId":"person_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/persongender"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameFamilyLatinStartsWith"},{"$ref":"#/components/parameters/nameFamilyLocalStartsWith"},{"$ref":"#/components/parameters/nameFullLatin"},{"$ref":"#/components/parameters/nameFullLatinContains"},{"$ref":"#/components/parameters/nameFullLocal"},{"$ref":"#/components/parameters/nameFullLocalContains"},{"$ref":"#/components/parameters/nationality"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/personIds"},{"$ref":"#/components/parameters/representing"},{"$ref":"#/components/parameters/representingCountry"},{"name":"search","description":"Searches the provided text in the fields nameFullLocal, nameAbbreviated, nameGivenLocal, nameFamilyLocal, nameFullLatin, nameGivenLatin, nameFamilyLatin","schema":{"type":"string"},"required":false,"in":"query"},{"name":"sortBy","description":"Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.","schema":{"type":"string","pattern":"^(\\-?nameFullLocal|\\-?nameFullLatin|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/personstatus"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Create a person

> Insert a new person

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons":{"post":{"tags":["Persons"],"summary":"Create a person","description":"Insert a new person","operationId":"person_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true}},"title":"person post body","required":["status","gender","nameFullLocal"]}}}}}}}}
```

## Get a person

> Return detailed information about a specific person

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons/{personId}":{"get":{"tags":["Persons"],"summary":"Get a person","description":"Return detailed information about a specific person","operationId":"person_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```

## Update a person

> Change the information of a specific person

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons/{personId}":{"put":{"tags":["Persons"],"summary":"Update a person","description":"Change the information of a specific person","operationId":"person_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true}},"title":"person put body"}}}}}}}}
```

## Delete a person

> Delete a specific person

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons/{personId}":{"delete":{"tags":["Persons"],"summary":"Delete a person","description":"Delete a specific person","operationId":"person_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```

## Create/Update a person

> Depending on data, Add a new person or update an existing one

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Baseball","version":"v1"},"tags":[{"name":"Persons","description":"A Person is a human being involved (playing in, organizing, officiating or in some other way) with the organization.\n\nA person belongs to only one organization. While logically a person could be involved over the course of their career in multiple organizations, in most cases (for the purpose of this API) they are treated as a different person.\n\nA person belongs in teams, matches, competitions etc by virtue of their season rosters, fixture rosters or roles.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<>[Persons{bg:orange}],[Persons]->[Fixture Roster],[Persons]->[Season Roster],[Persons]->[Roles],\">\n\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"PersonsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this person belongs to","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}}},"title":"person model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/persons/force":{"post":{"tags":["Persons"],"summary":"Create/Update a person","description":"Depending on data, Add a new person or update an existing one","operationId":"person_insert_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Persons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PersonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `DECEASED` Deceased\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n>- `UNREGISTERED` UnRegistered\n","type":"string","enum":["ACTIVE","UNREGISTERED","PENDING","DECEASED","INACTIVE"],"maxLength":30,"default":"ACTIVE"},"gender":{"description":"The gender of the person\n>- `FEMALE` Female\n>- `MALE` Male\n>- `UNKNOWN` Unknown\n","type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200},"nameAbbreviated":{"description":"An abbreviated name for a person","type":"string","maxLength":100,"nullable":true},"languageLocal":{"description":"The language code of the full name in [local](#section/Introduction/Character-Sets-and-Names) language. This code is a two letter (lower-case) ISO 639-1 language code.","type":"string","maxLength":2,"nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":200,"nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":200,"nullable":true},"dob":{"description":"Date of Birth","type":"string","format":"date","nullable":true},"nationality":{"description":"A 3 letter nationality code. We recommend you use ISO-3166 where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"deceased":{"description":"Date deceased","type":"string","format":"date","nullable":true},"additionalNames":{"type":"object","nullable":true,"description":"Additional names for the person. They are broken down by language, so you can have a different set of names per language","additionalProperties":{"type":"object","description":"The *property name* here can either be `default` (for a non-language specific name) or a two letter (lower-case) ISO 639-1 language code. eg `fr`, `es`","additionalProperties":false,"properties":{"display":{"type":"string","nullable":true},"television":{"description":"The name to be used on television","type":"string","nullable":true},"scoreboard":{"description":"The name to be used on the scoreboard","type":"string","nullable":true},"pronunciation":{"description":"The description of how to pronounce the name","type":"string","nullable":true},"boxscore":{"type":"string","nullable":true},"jersey":{"type":"string","nullable":true},"abbreviated":{"type":"string","nullable":true},"given":{"type":"string","nullable":true},"family":{"type":"string","nullable":true},"full":{"type":"string","nullable":true},"knownAs":{"type":"string","nullable":true}}},"pattern":"^(default|[a-z]{2})$"},"additionalDetails":{"title":"Person additional details","description":"Additional person detail fields","type":"object","nullable":true,"additionalProperties":false,"properties":{"height":{"description":"Height in cms","type":"number","nullable":true},"heightImperial":{"description":"Height in feet & inches","type":"string","nullable":true,"pattern":"^([4-7])'([0-9]|1[0-1])$"},"weight":{"description":"Weight in kgs","type":"number","nullable":true},"weightImperial":{"description":"Weight in pounds","type":"number","nullable":true},"dominantHand":{"description":"Dominant hand","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"dominantFoot":{"description":"Dominant foot","type":"string","nullable":true,"enum":["LEFT","RIGHT"]},"homeTown":{"description":"Hometown","type":"string","nullable":true},"school":{"description":"School","type":"string","nullable":true},"schoolClass":{"description":"School Class","type":"string","nullable":true},"college":{"description":"College","type":"string","nullable":true},"collegeClass":{"description":"College Class","type":"string","nullable":true},"representation":{"description":"Representation","type":"string","nullable":true},"juniorAssociationLeague":{"description":"Junior Association / League","type":"string","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"historicalNames":{"type":"array","nullable":true,"title":"Person historical names","description":"Array of person historical names","items":{"type":"object","title":"Person historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameFullLocal":{"description":"The full name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameGivenLocal":{"description":"Given name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFamilyLocal":{"description":"Family name of the person in [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","nullable":true},"nameFullLatin":{"description":"The full name of the person in [latin](##section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameGivenLatin":{"description":"Given name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true},"nameFamilyLatin":{"description":"Family name of the person in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","nullable":true}}}},"representing":{"description":"Who the person or team was representing","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true}},"title":"person post body","required":["status","gender","nameFullLocal"]}}}}}}}}
```