Skip to main content
Organisation branding allows you to customise the visual appearance of your verification workflows with your own logo. The logo is applied at the organisation level and is visible to all members of your team. Logo upload is managed through the Veridox dashboard — it is not available via the API. Only organisation owners can upload or change the logo. To upload your logo:
  1. Sign in to your regional dashboard:
  2. Go to SettingsOrganisation tab.
  3. Scroll to the Upload Branding Logo section and upload your image.
Supported formats: PNG, JPG, JPEG, or SVG (recommended: PNG).
Uploading a new logo will overwrite any previously saved logo for your organisation.
Once a logo has been uploaded via the dashboard, you can retrieve it programmatically:

Branding Workflow

Any organisation member can retrieve the current organisation logo.

Get Download URL

Response (Logo exists):
Response (No logo uploaded):

Display Logo in Application

Error Handling

API Key Errors

Best Practices

Retrieval Best Practices

  1. Cache URLs: Store download URLs briefly (respect 30-minute expiry)
  2. Lazy Loading: Load logos asynchronously to avoid blocking
  3. Fallbacks: Always have fallback branding when logo unavailable
  4. Refresh Logic: Check URL validity before using cached URLs
  5. Error Handling: Gracefully handle missing or expired logos

Security Considerations

  1. API Key Protection: Never expose API keys in client-side code
  2. Signed URLs: Respect URL expiration times
  3. HTTPS Only: Always use HTTPS for API communications
  4. CORS Awareness: Handle CORS properly for web applications
  5. Access Control: Understand admin vs member permission differences

Rate Limits

  • Download requests: 60 per hour per organisation
  • Download URL expiry: Signed download URLs expire after 30 minutes

Troubleshooting

Download Issues

  • 404 “resource does not exist”: No logo has been uploaded yet
  • “URL expired”: Request a fresh download URL
  • CORS errors: Ensure proper CORS configuration for your domain

Permission Issues

  • “Invalid API key”: Check API key format and validity
  • “Membership invalid”: User may have left the organisation

API Reference