Create case as managing partner
POST/managed-cases
Creates a collection case on behalf of your client (or yourself) through the Debitura platform.
Understanding the Creditor Field: The creditor is the party that the debtor owes money to. This can be: • Your client's company - When you're submitting cases on behalf of clients you represent • Your own company - When you're submitting your own debt collection cases
How It Works:
- You provide the creditor's basic information (company name + country)
- Debitura creates a creditor record (if one doesn't exist)
- The collection case is created under that creditor
- You are set as the managing partner
- The case is automatically assigned to a collection partner based on jurisdiction
Managing Partner Benefits: • Submit cases on behalf of your clients via API • Maintain your client relationships • Leverage Debitura's global partner network • Monitor case progress through read-only access • Provide full-service debt recovery to your clients
Required Fields: • CreditorCompanyName - The company name of who the debtor owes money to • CreditorCountryAlpha2 OR CreditorCountry - Creditor's country (provide either code or name) • CurrencyCode - Case currency (e.g., 'DKK', 'USD', 'EUR') • Date - Invoice issue date • AmountToRecover - Claim amount • Debtor - Complete debtor information with jurisdiction
Debtor Rules: • debtor.type must be "Company" or "Person" ◦ Company → debtor.name is mandatory (company name) ◦ Person → debtor.name is mandatory (person's full name) • For Company debtors, debtor.contactPerson is required • debtor.country (or debtor.countryAlpha2) is always required • debtor.state is optional - only provide if the debtor is in a specific state/region
Optional Fields: • DueDate - Invoice due date • Comments - Additional notes • ClaimDescription - Description of the claim • CreditorReference - Your client's internal reference • CollectionPartnerId - Override automatic partner matching • IsTest - Mark as test case (excluded from production metrics)
Response: Returns the created case details including the case ID, reference number, and assignment information.
Important Notes: • Creditor records are created fresh each time (no duplicate detection) • Contract requirements are automatically bypassed • Cases appear in your 'Managed Cases' list • You have read-only access to monitor case progress
Request
Responses
- 200
- 400
- 422
- 500
Case created successfully
Invalid request data (field validation errors)
Business rule violation (e.g., no partner available for jurisdiction)
Internal server error