Approve or reject a business (Admin)

Request

Sets approval status to approved or rejected. Rejected requires a reason.

Security

authJWT

Path

idstringrequired

Bodyapplication/jsonrequired

statusstringrequired

Approval decision

Enum:"approved""rejected"

Example:"approved"

reasonstring, <= 500 characters

Reason for rejection. Required when status is rejected.

curl -i -X PATCH \
  'https://docs.pers.ninja/_mock/swagger/businesses/{id}/approval' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "status": "approved",
    "reason": "string"
  }'

Responses

Business approval updated

Bodyapplication/json

idstringrequired

The id of the business, this is unique and will be used to identify the business.

emailstring or nullrequired

The email of the business, this is unique and will be used to identify the business.

currentSigningAccountIdstring or nullrequired

Current active signing account ID for external wallet operations

walletsArray of objects(PublicWalletDTO)required

Business-owned counterfactual smart contract wallets that can receive tokens

businessLegalNamestring or nullrequired

The legal name of the business, this is the name that will be used for legal purposes.

registrationNumberstring or nullrequired

The business registration number (e.g., company registration, VAT number, EIN)

displayNamestring or nullrequired

The display name of the business, this is the name that will be shown to the public.

descriptionstring or nullrequired

The description of the business, this is the description that will be shown to the public.

shortDescriptionstring or nullrequired

The short description of the business, this is the description that will be shown to the public.

websiteUrlstring or nullrequired

The website of the business, this is the website that will be shown to the public.

imageUrlstring or nullrequired

The image of the business, this is the image that will be shown to the public.

logoUrlstring or nullrequired

Logo URL for the business

streetAddressstring or nullrequired

The address of the business, this is the address that will be shown to the public.

phoneNumberstring or nullrequired

The phone number of the business.

neighborhoodstring or nullrequired

Neighborhood/area name (e.g., "West Bay", "Pearl Qatar", "Lusail") - auto-populated from geocoding

districtstring or nullrequired

District/administrative area - auto-populated from geocoding

citystring or nullrequired

The city of the business, this is the city that will be shown to the public.

postalCodestring or nullrequired

The postal code of the business, this is the postal code that will be shown to the public.

countrystring or nullrequired

The country of the business (auto-populated from geocoding if coordinates provided)

countryCodestring or nullrequired

ISO 3166-1 alpha-2 country code (e.g., QA, US, AE) - auto-populated from geocoding

Example:"QA"

coordsLatitudenumber or nullrequired

The latitude of the business, this is the latitude that will be shown to the public.

coordsLongitudenumber or nullrequired

The longitude of the business, this is the longitude that will be shown to the public.

businessTypeobject or null(BusinessTypeDTO)required

The business type of the business, this is the business type that will be shown to the public.

isActivebooleanrequired

The status of the business, this is the status that will be shown to the public.

approvalobject(ApprovalDTO)required

Approval metadata for this business.

canMintTokenbooleanrequired

The ability to mint token for the business, this is the ability that will be shown to the public.

Default:true

canChargeTokenbooleanrequired

The ability to charge token for the business, this is the ability that will be shown to the public.

Default:true

canManageUsersbooleanrequired

The ability to manage users for the business, this is the ability that will be shown to the public.

Default:true

canReceiveDonationbooleanrequired

The ability to receive donation for the business, this is the ability that will be shown to the public.

Default:true

tagsArray of stringsrequired

Tags for categorization and filtering

Default:[]

customDataobject or nullrequired

Custom business data including Google Places information (placeID, currentOpeningHours)

Example:

{
  "placeID": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "currentOpeningHours": {
    "open_now": true,
    "weekday_text": [ … ]
  }
}

accountAddressstring or nullrequireddeprecated

The address of the business, this is the address that will be shown to the public.

Response

{
  "id": "string",
  "email": "string",
  "accountAddress": "string",
  "currentSigningAccountId": "string",
  "wallets": [
    { … }
  ],
  "businessLegalName": "string",
  "registrationNumber": "string",
  "displayName": "string",
  "description": "string",
  "shortDescription": "string",
  "websiteUrl": "string",
  "imageUrl": "string",
  "logoUrl": "string",
  "streetAddress": "string",
  "phoneNumber": "string",
  "neighborhood": "string",
  "district": "string",
  "city": "string",
  "postalCode": "string",
  "country": "string",
  "countryCode": "QA",
  "coordsLatitude": 0,
  "coordsLongitude": 0,
  "businessType": {
    "id": "string",
    "name": "string",
    "description": "string",
    "code": "string",
    "iconUrl": "string"
  },
  "isActive": true,
  "approval": {
    "status": "pending_approval",
    "approvedAt": "2019-08-24T14:15:22Z",
    "approvedBy": "string",
    "rejectionReason": "string"
  },
  "canMintToken": true,
  "canChargeToken": true,
  "canManageUsers": true,
  "canReceiveDonation": true,
  "tags": [],
  "customData": {
    "placeID": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "currentOpeningHours": { … }
  }
}