# Get Profile Contact by username Retrieve available contact details for a profile by username, including email addresses, phone numbers and websites, with EnvoAPI. `GET https://api.envoapi.com/v1/profiles/contact/by-username` Operation ID: `getProfileContactByUsername` ## Authentication See [Authentication](https://docs.envoapi.com/guides/authentication.md). Security alternatives (each object is one alternative): ```json [ { "BearerApiKey": [] } ] ``` BearerApiKey: ```json { "type": "http", "scheme": "bearer", "bearerFormat": "envo_<66 Base64url characters>" } ``` ## Credits Uses the current contact-data Credit cost. Successful lookups are charged in full, even when contact fields are empty. Check your dashboard for current costs; example charges are illustrative. ## Parameters ### username Location: query. Required: yes. Schema: [ProfileUsernameSelector](https://docs.envoapi.com/api/schemas/ProfileUsernameSelector.md) Example: ```json "marismith" ``` ## Request example ```bash curl "https://api.envoapi.com/v1/profiles/contact/by-username?username=marismith" \ --header "Authorization: Bearer $ENVO_API_KEY" \ --header "Accept: application/json" ``` ## Responses ### 200 Profile contact data. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ProfileContactSuccess](https://docs.envoapi.com/api/schemas/ProfileContactSuccess.md) | Field | Required | Schema | Description | | ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | data | yes | [Contact](https://docs.envoapi.com/api/schemas/Contact.md) | The result of the call. Fields we cannot fill are null. | | data.emailAddress | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":320},{"type":"null"}]} | The person's email address. | | data.phoneNumbers | yes (when parent present) | {"anyOf":\[{"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/ContactPhone"},"uniqueItems":true},{"type":"null"}]} | Phone numbers found on the profile. | | data.websites | yes (when parent present) | {"anyOf":\[{"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/ContactWebsite"},"uniqueItems":true},{"type":"null"}]} | Links from the profile. | | data.socialHandles | yes (when parent present) | {"anyOf":\[{"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/SocialHandle"},"uniqueItems":true},{"type":"null"}]} | Other social accounts. | | data.birthdate | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/BirthDate"},{"type":"null"}]} | Date of birth. Each part can be null, but at least one part is always set. Many profiles hide the year. | | data.address | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]} | The postal address as one line of text. | | meta | yes | [ProfileSuccessMetadata](https://docs.envoapi.com/api/schemas/ProfileSuccessMetadata.md) | Information about the call itself. | | meta.creditCost | yes (when parent present) | [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md) | How many credits this call used. | Response example: ```json { "data": { "emailAddress": null, "phoneNumbers": [], "websites": [ { "url": "https://www.facebook.com/marismith", "category": "other", "label": null }, { "url": "https://www.marismith.com/beyondfollowers/", "category": "other", "label": null }, { "url": "https://www.marismith.com/mentalhealth/", "category": "other", "label": null } ], "socialHandles": [], "birthdate": { "year": null, "month": 1, "day": 1 }, "address": null }, "meta": { "creditCost": 1 } } ``` ### 400 A request parameter is missing or invalid. A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [InvalidRequestErrorResponse](https://docs.envoapi.com/api/schemas/InvalidRequestErrorResponse.md) ### 401 Your API key is invalid or inactive. Your API key is missing, wrong or switched off. Check it in your dashboard. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [InvalidApiKeyErrorResponse](https://docs.envoapi.com/api/schemas/InvalidApiKeyErrorResponse.md) ### 402 Your account does not have enough credits. Your account has no credits left. Top up, then send a new call. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [InsufficientCreditsErrorResponse](https://docs.envoapi.com/api/schemas/InsufficientCreditsErrorResponse.md) ### 403 Your API key or account cannot access this endpoint. Your account is suspended or cannot use this endpoint. Resolve the account or its access first. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [LookupForbiddenErrorResponse](https://docs.envoapi.com/api/schemas/LookupForbiddenErrorResponse.md) ### 404 The requested resource was not found. Nothing matched what you sent. Check it for typos. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ResourceNotFoundErrorResponse](https://docs.envoapi.com/api/schemas/ResourceNotFoundErrorResponse.md) ### 405 Use GET for this endpoint. The route exists, but the request used a method other than GET. Use the method shown at the top of this page. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **Allow**: Required response header. Schema: {"type":"string","const":"GET"}. Content type: `application/json`. Schema: [MethodNotAllowedErrorResponse](https://docs.envoapi.com/api/schemas/MethodNotAllowedErrorResponse.md) ### 406 The response format in your Accept header is not supported. The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [NotAcceptableErrorResponse](https://docs.envoapi.com/api/schemas/NotAcceptableErrorResponse.md) ### 415 The Content-Type in your request is not supported. The request declared a media type we do not accept. Remove the body or use the documented media type. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [UnsupportedMediaTypeErrorResponse](https://docs.envoapi.com/api/schemas/UnsupportedMediaTypeErrorResponse.md) ### 429 Your account has sent too many requests. Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **Retry-After**: Seconds to wait before you try again. Schema: [PositiveSafeInteger](https://docs.envoapi.com/api/schemas/PositiveSafeInteger.md). Content type: `application/json`. Schema: [RateLimitExceededErrorResponse](https://docs.envoapi.com/api/schemas/RateLimitExceededErrorResponse.md) ### 500 A server error prevented the request from completing. Something failed on our side. Retry only when error.retryable is true. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [InternalServerErrorResponse](https://docs.envoapi.com/api/schemas/InternalServerErrorResponse.md) ### 502 A data source returned an invalid response. A data source sent back something we could not use. Retry with bounded backoff. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [UpstreamErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamErrorResponse.md) ### 503 The service is unavailable. Check error.retryable before retrying. Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **Retry-After**: Seconds to wait before you try again. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ServiceUnavailableErrorResponse](https://docs.envoapi.com/api/schemas/ServiceUnavailableErrorResponse.md) ### 504 The request timed out. The lookup ran out of time. Retry with bounded backoff. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [UpstreamTimeoutErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamTimeoutErrorResponse.md) ## Related documentation * [Authentication](https://docs.envoapi.com/guides/authentication.md) * [Errors](https://docs.envoapi.com/guides/errors.md) * [Pagination](https://docs.envoapi.com/guides/pagination.md) * [Rate limits](https://docs.envoapi.com/guides/rate-limits.md) * [Get a Profile's recent posts.](https://docs.envoapi.com/api/operations/getprofileposts.md) * [Get a Profile's recent comments.](https://docs.envoapi.com/api/operations/getprofilecomments.md) * [Get a Profile's recent reactions.](https://docs.envoapi.com/api/operations/getprofilereactions.md) * [Get profiles similar to a Profile.](https://docs.envoapi.com/api/operations/getsimilarprofiles.md) * [Get Profile Details by URL](https://docs.envoapi.com/api/operations/getprofiledetailsbyurl.md) * [Get Profile Details by username](https://docs.envoapi.com/api/operations/getprofiledetailsbyusername.md) * [Get Profile Details by ID](https://docs.envoapi.com/api/operations/getprofiledetailsbyid.md) * [Get Profile Contact by URL](https://docs.envoapi.com/api/operations/getprofilecontactbyurl.md) * [Get Profile Full Experience by URL](https://docs.envoapi.com/api/operations/getprofilefullexperiencebyurl.md) * [Get Profile Full Experience by username](https://docs.envoapi.com/api/operations/getprofilefullexperiencebyusername.md) * [Get Profile Education by URL](https://docs.envoapi.com/api/operations/getprofileeducationbyurl.md) * [Get Profile Education by username](https://docs.envoapi.com/api/operations/getprofileeducationbyusername.md) * [Get Profile Skills by URL](https://docs.envoapi.com/api/operations/getprofileskillsbyurl.md) * [Get Profile Skills by username](https://docs.envoapi.com/api/operations/getprofileskillsbyusername.md) * [Get Profile Certifications by URL](https://docs.envoapi.com/api/operations/getprofilecertificationsbyurl.md) * [Get Profile Certifications by username](https://docs.envoapi.com/api/operations/getprofilecertificationsbyusername.md) * [Get Profile Courses by URL](https://docs.envoapi.com/api/operations/getprofilecoursesbyurl.md) * [Get Profile Courses by username](https://docs.envoapi.com/api/operations/getprofilecoursesbyusername.md) * [Get Profile Company Interests by URL](https://docs.envoapi.com/api/operations/getprofilecompanyinterestsbyurl.md) * [Get Profile Company Interests by username](https://docs.envoapi.com/api/operations/getprofilecompanyinterestsbyusername.md) * [Get Profile Company Interests by ID](https://docs.envoapi.com/api/operations/getprofilecompanyinterestsbyid.md) * [Get Profile Volunteer Experience by URL](https://docs.envoapi.com/api/operations/getprofilevolunteerexperiencebyurl.md) * [Get Profile Volunteer Experience by username](https://docs.envoapi.com/api/operations/getprofilevolunteerexperiencebyusername.md) [Documentation index](https://docs.envoapi.com/llms.txt) ยท [All endpoints](https://docs.envoapi.com/api/index.md)