> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes. # get > Retrieve a specific address. Retrieve a specific address. ### Schema ```yaml openapi: 3.1.0 info: title: API version: 1.0.0 paths: /api/relay/rest/addresses/{id}: get: operationId: subpackageE911Addresses_get_address summary: Get E911 address description: >- Retrieves one physical E911 service address from your SignalWire project. Use [List E911 addresses](/docs/apis/rest/e-911-addresses/list-addresses) to find address IDs, or [Get phone number](/docs/apis/rest/phone-numbers/retrieve-phone-number) to inspect the address currently assigned to a number. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). tags: - subpackage_e911Addresses parameters: - name: id in: path description: Unique ID of the address. required: true schema: $ref: '#/components/schemas/uuid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AddressResponse' '401': description: Access is unauthorized. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.StatusCode401' '404': description: The server cannot find the requested resource. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.StatusCode404' '422': description: The request failed validation. See errors for details. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.ValidationError' '500': description: An internal server error occurred. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.StatusCode500' tags: - name: subpackage_e911Addresses servers: - url: https://%7BYour_Space_Name%7D.signalwire.com description: SignalWire API components: schemas: uuid: type: string format: uuid description: Universal Unique Identifier. title: uuid AddressType: type: string enum: - Apartment - Basement - Building - Department - Floor - Office - Penthouse - Suite - Trailer - Unit description: Address type for sub-addresses. title: AddressType AddressResponse: type: object properties: id: $ref: '#/components/schemas/uuid' description: The unique identifier of the Address on SignalWire. label: type: string description: >- A friendly name given to the address to help distinguish and search for different addresses within your project. country: type: string description: The ISO 3166 Alpha 2 country code. first_name: type: string description: First name of the occupant associated with this address. last_name: type: string description: Last name of the occupant associated with this address. street_number: type: string description: The number portion of the street address. street_name: type: string description: The name portion of the street address. address_type: oneOf: - $ref: '#/components/schemas/AddressType' - type: 'null' description: >- If the address is divided into multiple sub-addresses, this identifies how the address is divided. address_number: type: - string - 'null' description: >- If the address is divided into multiple sub-addresses, this identifies the particular sub-address. city: type: string description: The city portion of the street address. state: type: string description: >- The state/province/region of the street address. In the USA and Canada, use the two-letter abbreviated form. postal_code: type: string description: The postal code of the street address. zip_code: type: string description: >- The postal code of the street address. Alias for postal_code for backwards compatibility. emergency_enabled: type: boolean description: >- Whether E911 emergency calling is enabled for this address (carrier-validated when created/updated with `emergency_enabled=true` for a US address). validated: type: boolean description: >- Whether the address was validated by the carrier (true when the carrier returned a valid or auto-corrected match). validated_at: type: - string - 'null' description: >- The RFC 3339 / ISO 8601 timestamp of the last successful carrier validation, or null if never validated. required: - id - label - country - first_name - last_name - street_number - street_name - address_type - address_number - city - state - postal_code - zip_code - emergency_enabled - validated - validated_at description: Response containing a single address. title: AddressResponse TypesStatusCodesStatusCode401Error: type: string enum: - Unauthorized title: TypesStatusCodesStatusCode401Error Types.StatusCodes.StatusCode401: type: object properties: error: $ref: '#/components/schemas/TypesStatusCodesStatusCode401Error' required: - error description: Access is unauthorized. title: Types.StatusCodes.StatusCode401 TypesStatusCodesStatusCode404Error: type: string enum: - Not Found title: TypesStatusCodesStatusCode404Error Types.StatusCodes.StatusCode404: type: object properties: error: $ref: '#/components/schemas/TypesStatusCodesStatusCode404Error' required: - error description: The server cannot find the requested resource. title: Types.StatusCodes.StatusCode404 Types.StatusCodes.SpaceApiErrorItem: type: object properties: detail: type: string description: A description of what caused the error. status: type: string description: The HTTP status code. title: type: string description: A short summary of the error type. code: type: string description: The error code. required: - detail - status - title - code description: Details about a specific validation error. title: Types.StatusCodes.SpaceApiErrorItem Types.StatusCodes.ValidationError: type: object properties: errors: type: array items: $ref: '#/components/schemas/Types.StatusCodes.SpaceApiErrorItem' description: List of validation errors. required: - errors description: The request failed validation. See errors for details. title: Types.StatusCodes.ValidationError TypesStatusCodesStatusCode500Error: type: string enum: - Internal Server Error title: TypesStatusCodesStatusCode500Error Types.StatusCodes.StatusCode500: type: object properties: error: $ref: '#/components/schemas/TypesStatusCodesStatusCode500Error' required: - error description: An internal server error occurred. title: Types.StatusCodes.StatusCode500 ``` ## **Response Example** ### Response (200) ```json { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "label": "My Address", "country": "US", "first_name": "Emmett", "last_name": "Brown", "street_number": "1640", "street_name": "Riverside Drive", "address_type": "Apartment", "address_number": "42", "city": "Alexandria", "state": "CA", "postal_code": "91905", "zip_code": "91905", "emergency_enabled": false, "validated": false, "validated_at": null } ``` ## **Example** ```typescript {9-10} import { RestClient } from "@signalwire/sdk"; const client = new RestClient({ project: "your-project-id", token: "your-api-token", host: "your-space.signalwire.com" }); const addr = await client.addresses.get("address-id"); console.log(addr["customer_name"], addr.street); ``` > Retrieve a specific address.