> ## Documentation Index > Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Phones > Returning all phones that belong to a person, ordered by the phone type. NsApiSlow threshold: 2000 ms. ## OpenAPI ````yaml /openapi/agent/openapi-v3-PersonAgent.json post /api/v1/Agents/Person/GetPhones openapi: 3.0.0 info: version: v1-Agents title: SuperOffice Agent API v1 description: SuperOffice Agent API - PersonAgent contact: name: SuperOffice DevNet url: https://docs.superoffice.com/en/api/index.html email: sdk@superoffice.com servers: - url: http://localhost:56350 - url: https://localhost:56350 security: [] tags: [] externalDocs: description: >- The SuperOffice DevNet Community has more documentation, examples, and discussion forums. url: https://community.superoffice.com/en/developer/ paths: /api/v1/Agents/Person/GetPhones: post: tags: - Person_Agent summary: Get Phones description: |- Returning all phones that belong to a person, ordered by the phone type. NsApiSlow threshold: 2000 ms. operationId: v1PersonAgent_GetPhones parameters: - name: $select in: query description: >- Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields. required: false schema: type: string - name: Accept-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. required: false schema: type: string - name: SO-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. required: false schema: type: string - name: SO-Culture in: header description: >- Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. required: false schema: type: string - name: SO-TimeZone in: header description: >- Specify the timezone code that you would like date/time responses converted to. required: false schema: type: string - name: SO-AppToken in: header description: >- The application token that identifies the partner app. Used when calling Online WebAPI from a server. required: false schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest text/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest application/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest text/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest application/json-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest application/merge-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest description: PersonId required: true responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' text/json: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' application/xml: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' text/xml: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' application/json-patch+json: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' application/merge-patch+json: schema: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.EntityElement' security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.WebApi.v1.Carriers.PersonCarriers.GetPhonesRequest: description: >- GetPhones: Returning all phones that belong to a person, ordered by the phone type. type: object properties: PersonId: format: int32 type: integer SuperOffice.CRM.Services.EntityElement: description: "Generic carrier object for entity elements such as Phone, EntityElement, Url. These elements do not have id and rank. These values are changed on each save, and should not be depended on. When used in a list or array the rank is the ascending list order.\r\n\r\nCarrier object for EntityElement." type: object properties: Value: description: >- The Element FullName. This is a value that is intended to be shown to the user. type: string StrippedValue: description: >- The Element FullName. This is a value that can be parsed and used by systems. type: string Description: description: The Element Description type: string TableRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight' FieldProperties: description: >- Field property dictionary mapping field names to field access rights. type: object additionalProperties: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty' SuperOffice.CRM.Security.TableRight: description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted." type: object properties: Mask: type: string Reason: type: string SuperOffice.CRM.Security.FieldProperty: description: >- Class holding properties like field length, field type about a field in the carrier. type: object properties: FieldRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight' FieldType: type: string FieldLength: format: int32 description: '' type: integer SuperOffice.CRM.Security.FieldRight: description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined." type: object properties: Mask: type: string Reason: type: string ```` ## Related topics - [SuperOffice.WebApi.Data.Person GetPhonesRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.Person_GetPhonesRequest.md) - [Get Favorites Phones](/en/api/reference/restful/agent/phonelist_agent/get-favorites-phones.md) - [Get Contact Phones](/en/api/reference/restful/agent/phonelist_agent/get-contact-phones.md) - [Get Department Phones](/en/api/reference/restful/agent/phonelist_agent/get-department-phones.md) - [NSPhoneListAgent](/en/automation/crmscript/reference/CRMScript.NetServer.NSPhoneListAgent.md) - [NSPhoneListItem](/en/automation/crmscript/reference/CRMScript.NetServer.NSPhoneListItem.md)