--- title: "Get sender for project" method: GET path: "/v1/projects/{projectId}/whatsapp/senders/{senderId}" tags: ["WhatsApp Senders"] --- # Get sender for project `GET /v1/projects/{projectId}/whatsapp/senders/{senderId}` ## Request - Base URL: `https://provisioning.api.sinch.com` - URL: `https://provisioning.api.sinch.com/v1/projects/{projectId}/whatsapp/senders/{senderId}` - Auth: HTTP basic and HTTP bearer and OAuth 2 - Client credentials - Token URL: `https://auth.sinch.com/oauth2/token` Returns a sender for a project. ## Path parameters - `projectId` string, required - `senderId` string, required ## Response `200` Sender - WhatsappSenderDto - `id` string, required: The unique ID of the sender. - `state` 'ACTIVE' | 'IN_PROGRESS' | 'INACTIVE' | 'PENDING_VERIFICATION' | 'SUSPENDED' | 'ERROR': The current state of the sender. - `changes` WhatsappSenderChangesDto - `status` 'DRAFT' | 'ERROR' | 'IN_PROGRESS' | 'MULTIPLE_WABA_ERROR' | 'REJECTED', required: Current status of the pending changes. - `details` union: The pending changes to sender details and information - object - `displayName` string, required: Sender display name within WhatsApp. - `description` string: Description of the sender displayed in the Business Info within WhatsApp. - `vertical` 'ALCOHOL' | 'AUTOMOTIVE' | 'BEAUTY_SPA_SALON' | 'CLOTHING_AND_APPAREL' | 'EDUCATION' | 'ENTERTAINMENT' | 'EVENT_PLANNING_AND_SERVICE' | 'FINANCE_AND_BANKING' | 'FOOD_AND_GROCERY' | 'HOTEL_AND_LODGING' | 'MEDICAL_AND_HEALTH' | 'NON_PROFIT' | 'NOT_SET' | 'ONLINE_GAMBLING' | 'OTC_DRUGS' | 'OTHER' | 'PHYSICAL_GAMBLING' | 'PROFESSIONAL_SERVICES' | 'PUBLIC_SERVICE' | 'RESTAURANT' | 'SHOPPING_AND_RETAIL' | 'TRAVEL_AND_TRANSPORTATION' | 'UNRECOGNIZED', required: Category of the sender displayed in the Business Info within WhatsApp. - `email` string: Contact email displayed in the Business Info within WhatsApp. - `address` string: Business address displayed in the Business Info within WhatsApp. - `websiteOne` string: Business website displayed in the Business Info within WhatsApp. - `websiteTwo` string: Second business website displayed in the Business Info within WhatsApp. - `about` string: About text displayed in the Business Info within WhatsApp. - Hyperlinks can be included but will not render as clickable links. - Markdown is not supported. - `photoUrl` string: URL to the sender image displayed in WhatsApp. - Supported mime types: `image/jpeg`, `image/png` or `image/webp`. - Maximum file size: 5MB. - Minimum image dimensions: 192 x 192 px. - Maximum image dimensions: 640 x 640 px. - Image will be cropped to maximum image dimensions. - If you submit a PNG image with a transparent background, the background will be rendered as black. - `username` string: WhatsApp Business username of the sender. - object - `displayName` string: Sender display name within WhatsApp. - `description` string: Description of the sender displayed in the Business Info within WhatsApp. - `vertical` 'ALCOHOL' | 'AUTOMOTIVE' | 'BEAUTY_SPA_SALON' | 'CLOTHING_AND_APPAREL' | 'EDUCATION' | 'ENTERTAINMENT' | 'EVENT_PLANNING_AND_SERVICE' | 'FINANCE_AND_BANKING' | 'FOOD_AND_GROCERY' | 'HOTEL_AND_LODGING' | 'MEDICAL_AND_HEALTH' | 'NON_PROFIT' | 'NOT_SET' | 'ONLINE_GAMBLING' | 'OTC_DRUGS' | 'OTHER' | 'PHYSICAL_GAMBLING' | 'PROFESSIONAL_SERVICES' | 'PUBLIC_SERVICE' | 'RESTAURANT' | 'SHOPPING_AND_RETAIL' | 'TRAVEL_AND_TRANSPORTATION' | 'UNRECOGNIZED': Category of the sender displayed in the Business Info within WhatsApp. - `email` string: Contact email displayed in the Business Info within WhatsApp. - `address` string: Business address displayed in the Business Info within WhatsApp. - `websiteOne` string: Business website displayed in the Business Info within WhatsApp. - `websiteTwo` string: Second business website displayed in the Business Info within WhatsApp. - `about` string: About text displayed in the Business Info within WhatsApp. - Hyperlinks can be included but will not render as clickable links. - Markdown is not supported. - `photoUrl` string: URL to the sender image displayed in WhatsApp. - Supported mime types: `image/jpeg`, `image/png` or `image/webp`. - Maximum file size: 5MB. - Minimum image dimensions: 192 x 192 px. - Maximum image dimensions: 640 x 640 px. - Image will be cropped to maximum image dimensions. - If you submit a PNG image with a transparent background, the background will be rendered as black. - `username` string: WhatsApp Business username of the sender. - `errorReason` string: Error reason if sender is in state `ERROR`. - `errorCode` 'CANNOT_ASSIGN_CREDIT_LINE' | 'CANNOT_ASSIGN_SYSTEM_USER' | 'CANNOT_CREATE_NEW_WHATSAPP_SENDER' | 'CANNOT_CREATE_WABA_FOR_BUSINESS' | 'CANNOT_GET_DETAILS_FOR_CLOUD_API' | 'CANNOT_GET_WABA_DETAILS' | 'CANNOT_REGISTER_NEW_WHATSAPP_SENDER' | 'CANNOT_REGISTER_TO_CLOUD_API' | 'CANNOT_SUBSCRIBE_TO_CLOUD_API' | 'CANNOT_SUBSCRIBE_TO_WEBHOOK' | 'DUPLICATES_ON_SENDER_PHONE_NUMBER' | 'FAILED_TO_FETCH_APPROVED_MESSAGE_TEMPLATES' | 'MULTIPLE_WABA_FOR_PROJECT_ID' | 'NO_CERTIFICATE_AVAILABLE' | 'NO_NOVA_ACCOUNT_ID' | 'NO_PRICING_PLAN' | 'NO_PROJECT_ID' | 'NO_VERIFIED_PHONE_NUMBER' | 'NOT_VERIFIED_REQUESTED_PHONE_NUMBER' | 'NOT_VERIFY_BUSINESS_VIA_WHATSAPP' | 'NOVA_ACCOUNT_ID_CONFLICT' | 'PROJECT_ID_CONFLICT' | 'REQUESTED_PHONE_NUMBER_OR_COUNTRY_CODE_CONFLICT' | 'SENDER_HAS_BEEN_DELETED' | 'WABA_CONNECTED_TO_ANOTHER_PROJECT' | 'UNKNOWN_ERROR' | 'UNRECOGNIZED': Error code if sender is in state `ERROR`. - `details` WhatsappSenderDetailsDto - `displayName` string, required: Sender display name within WhatsApp. - `description` string: Description of the sender displayed in the Business Info within WhatsApp. - `vertical` 'ALCOHOL' | 'AUTOMOTIVE' | 'BEAUTY_SPA_SALON' | 'CLOTHING_AND_APPAREL' | 'EDUCATION' | 'ENTERTAINMENT' | 'EVENT_PLANNING_AND_SERVICE' | 'FINANCE_AND_BANKING' | 'FOOD_AND_GROCERY' | 'HOTEL_AND_LODGING' | 'MEDICAL_AND_HEALTH' | 'NON_PROFIT' | 'NOT_SET' | 'ONLINE_GAMBLING' | 'OTC_DRUGS' | 'OTHER' | 'PHYSICAL_GAMBLING' | 'PROFESSIONAL_SERVICES' | 'PUBLIC_SERVICE' | 'RESTAURANT' | 'SHOPPING_AND_RETAIL' | 'TRAVEL_AND_TRANSPORTATION' | 'UNRECOGNIZED', required: Category of the sender displayed in the Business Info within WhatsApp. - `email` string: Contact email displayed in the Business Info within WhatsApp. - `address` string: Business address displayed in the Business Info within WhatsApp. - `websiteOne` string: Business website displayed in the Business Info within WhatsApp. - `websiteTwo` string: Second business website displayed in the Business Info within WhatsApp. - `about` string: About text displayed in the Business Info within WhatsApp. - Hyperlinks can be included but will not render as clickable links. - Markdown is not supported. - `photoUrl` string: URL to the sender image displayed in WhatsApp. - Supported mime types: `image/jpeg`, `image/png` or `image/webp`. - Maximum file size: 5MB. - Minimum image dimensions: 192 x 192 px. - Maximum image dimensions: 640 x 640 px. - Image will be cropped to maximum image dimensions. - If you submit a PNG image with a transparent background, the background will be rendered as black. - `username` string: WhatsApp Business username of the sender. - `metadata` WhatsappSenderMetadataDto - `displayName` WhatsappSenderMetadataFieldDto - `value` string: Requested value of the field. - `status` 'APPROVED' | 'DEFERRED' | 'DELETED' | 'EXPIRED' | 'PENDING' | 'REJECTED' | 'RESERVED' | 'UNRECOGNIZED' | 'UNSPECIFIED', required: Current approval status of the field. - `rejectionReason` string: Reason for rejection if the field update was rejected. - `username` WhatsappSenderMetadataFieldDto - `value` string: Requested value of the field. - `status` 'APPROVED' | 'DEFERRED' | 'DELETED' | 'EXPIRED' | 'PENDING' | 'REJECTED' | 'RESERVED' | 'UNRECOGNIZED' | 'UNSPECIFIED', required: Current approval status of the field. - `rejectionReason` string: Reason for rejection if the field update was rejected. - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required: Region sender is provisioned in. - `metaLocalStorage` 'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'US' | 'ZA' | 'UNRECOGNIZED' | 'UNSPECIFIED', required: Region sender store the data in Meta. - `conversationApiApp` string: If set, the Conversation API App ID the sender is connected to. - `conversationApiAppDetails` WhatsappConversationApiAppDto - `id` string, required: ID of the app - `projectId` string, required: ID of the app project - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required: App region. - `channelStatus` 'ACTIVE' | 'FAILING' | 'PENDING' | 'UNRECOGNIZED': Status of the channel credentials integration. - `maxTps` number: Maximum sender TPS. - `qualityRating` 'GREEN' | 'RED' | 'YELLOW' | 'UNKNOWN' | 'UNRECOGNIZED': Current quality rating of the sender. - `dailyLimit` 'NOT_SET' | 'TIER_100K' | 'TIER_10K' | 'TIER_1K' | 'TIER_250' | 'TIER_2K' | 'TIER_50' | 'TIER_UNLIMITED' | 'UNRECOGNIZED': This property is deprecated. Use `AccountDto.businessDailyLimit` instead. Current daily message limit of the sender. - `bearerToken` string: Bearer token of the sender. The bearer token is needed to connect the sender to a Conversation API App. - `cloudApi` boolean, required: True if the sender is hosted in WhatsApp Cloud API. - `created` string: The UTC Date Time in ISO 8601 for when the sender was created. - `modified` string: The UTC Date Time in ISO 8601 for when the sender was last modified. - `countryCode` string: Country code of sender phone number. - `phoneNumber` string: Sender phone number without country code. - `numberProvider` 'CUSTOMER' | 'SINCH' | 'UNRECOGNIZED': Provider for phone number. - `businessManager` 'SINCH_AMERICA' | 'SINCH_BR' | 'SINCH_MX' | 'SINCH_SEP' | 'SINCH_UK' | 'UNRECOGNIZED', required: Business manager. - `wabaBanState` 'DISABLE' | 'REINSTATE' | 'SCHEDULE_FOR_DISABLE' | 'UNRECOGNIZED': Please use get account endpoint for this information. - `wabaBanDate` string: Please use get account endpoint for this information. - `compatibleRegions` WhatsappConversationAppRegionsEnum[], required: Conversation API app regions the sender can be used for. ## Other responses - `400`: BadRequest - `401`: Unauthorized - `404`: NotFound - `500`: InternalServerError ## Changes > 17 revisions in range; 1 not diffed. - **2026-09-17** `cb49a3396ef4`: 1 warning - added the new `REQUESTED_PHONE_NUMBER_OR_COUNTRY_CODE_CONFLICT` enum value to the `changes/allOf[#/components/schemas/WhatsappSenderChangesDto]/errorCode/allOf[#/components/schemas/WhatsappSenderErrorCodeEnum]/` response property for the response status `200` - **2026-09-01** `c6a937922d10`: 21 breaking, 213 info - the response's body type changed from no type to `object` for status `400` - the response's body type changed from no type to `object` for status `401` - the response's body type changed from no type to `object` for status `404` - the response's body type changed from no type to `object` for status `500` - …230 more - **2026-08-18** `c78a716de420`: 2 info - api operation id `SendersController_get_v1` removed and replaced with `WhatsappSendersController_get_v1` - added the optional property `metadata/allOf[#/components/schemas/WhatsappSenderMetadataDto]/displayName` to the response with the `200` status [Operation history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/whatsapp/senders/:senderId/get.md) --- [API](https://skmtc.dev/sinch/apis/provisioning-api.md) - [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/provisioning-api/revisions/90d78b3a8575?raw)