Justt REST API

{"openapi":"3.0.0","paths":{"/transactions":{"post":{"description":"Creates or updates a transaction record for additional purchases or activities made by a customer who has an existing chargeback case. This helps provide additional context for dispute resolution.","operationId":"TransactionController_createTransaction","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Transaction data to be created or updated in the system","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTransactionDto"}}}},"responses":{"201":{"description":"Returns success if the transaction data was stored successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Upsert transaction","tags":["Transactions"]}},"/chargebacks":{"get":{"description":"Retrieving a array of chargebacks matching the given criteria","operationId":"ChargebackController_findAll","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"The number of items to return between 10 to 100","schema":{"default":10,"example":"10","type":"number"}},{"name":"page","required":false,"in":"query","description":"The offset of the first item to return","schema":{"default":1,"example":"1","type":"number"}},{"name":"startDate","required":false,"in":"query","description":"Start date (of the posting date) for date range filtering (ISO 8601 in UTC)","schema":{"format":"date-time","example":"2023-01-01T00:00:00Z","type":"string"}},{"name":"endDate","required":false,"in":"query","description":"End date (of the posting date) for date range filtering (ISO 8601 in UTC)","schema":{"format":"date-time","example":"2023-01-31T23:59:59Z","type":"string"}},{"name":"chargebackId","required":false,"in":"query","description":"A unique chargeback Identifier set by the PSP","schema":{"example":"QRZ54SXB4K6TF232","type":"string"}},{"name":"psp","required":false,"in":"query","description":"The name of the PSP in which the transaction was processed","schema":{"$ref":"#/components/schemas/PSP"}},{"name":"pspStatus","required":false,"in":"query","description":"The status of the chargeback in the PSP system","schema":{"$ref":"#/components/schemas/PSPStatus"}},{"name":"status","required":false,"in":"query","description":"The status of the chargeback in Justt system","schema":{"$ref":"#/components/schemas/InternalStatus"}},{"name":"minEnrichmentScore","required":false,"in":"query","description":"Minimum enrichment score to filter by (0-1)","schema":{"example":0.75,"type":"number"}},{"name":"maxEnrichmentScore","required":false,"in":"query","description":"Maximum enrichment score to filter by (0-1)","schema":{"example":0.95,"type":"number"}},{"name":"pspStatusChangeStartDate","required":false,"in":"query","description":"Start date for PSP status change date filtering (ISO 8601 in UTC)","schema":{"format":"date-time","example":"2023-01-01T00:00:00Z","type":"string"}},{"name":"pspStatusChangeEndDate","required":false,"in":"query","description":"End date for PSP status change date filtering (ISO 8601 in UTC)","schema":{"format":"date-time","example":"2023-01-31T23:59:59Z","type":"string"}}],"responses":{"200":{"description":"Returns the chargebacks data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetChargebacksResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get chargebacks by search criteria","tags":["Chargebacks"]}},"/chargebacks/{id}":{"get":{"description":"Retrieving a single chargeback by id","operationId":"ChargebackItemController_getChargeback","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"responses":{"200":{"description":"Returns the chargeback data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetChargebackResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get chargeback","tags":["Chargebacks"]},"patch":{"description":"To see your full request body parameters names please check you data boost page at the hub https://app.justt.ai/datapoints-list","operationId":"ChargebackItemController_updateChargeback","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"requestBody":{"required":true,"description":"dynamic body param according to your solution at https://app.justt.ai/datapoints-list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"responses":{"201":{"description":"Returns success if the chargeback data was updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Update chargeback","tags":["Chargebacks"]}},"/chargebacks/{id}/should-fight":{"patch":{"description":"By default, Justt will represent or not represent chargebacks as agreed in your contract. Use this endpoint to override this for a specific chargeback","operationId":"ChargebackItemController_markShouldFight","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShouldFightDto"}}}},"responses":{"201":{"description":"Returns success if the chargeback was marked to fight/not fight successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Should Justt fight for a given chargeback","tags":["Chargebacks"]}},"/chargebacks/{id}/accept":{"post":{"description":"Accepts a chargeback, indicating you will not dispute it. This action acknowledges the validity of the customer's claim and allows the funds to be returned to them. The chargeback must have an open status and your payment processor must support acceptance. Once accepted, the chargeback cannot be reversed.","operationId":"ChargebackItemController_acceptChargeback","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"responses":{"200":{"description":"Chargeback accepted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Accept chargeback","tags":["Chargebacks"]},"get":{"description":"Returns the current status of an accept chargeback for a chargeback. Accept chargeback is an asynchronous process, so this endpoint allows you to check the real-time state of the accept (e.g., in progress, completed, failed).","operationId":"ChargebackItemController_getAcceptChargebackStatus","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"responses":{"200":{"description":"Returns Accept chargeback status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptChargebackStatusDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get the status of an accept chargeback","tags":["Chargebacks"]}},"/chargebacks/{id}/evidence/submit":{"post":{"description":"Submits a request to attach evidence to a chargeback. The evidence will be processed asynchronously; the request will return immediately with a submission ID, and the evidence will be submitted in the background, the process will take up to 24 hours to complete, depending on the payment processor.","operationId":"EvidenceController_submitEvidence","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitEvidenceDto"}}}},"responses":{"201":{"description":"Returns success if the evidence submitted request accepted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Request to submit evidence for a chargeback","tags":["Evidence"]}},"/chargebacks/{id}/evidence/submit/{submitEvidenceId}":{"get":{"description":"Returns the current status of an evidence submission for a chargeback. Evidence submission is an asynchronous process, so this endpoint allows you to check the real-time state of the submission (e.g., in progress, completed, failed).","operationId":"EvidenceController_getEvidenceSubmissionStatus","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"submitEvidenceId","required":true,"in":"path","description":"The submit evidence ID","schema":{"example":"63e3830ed8cbb72dce2164b1","type":"string"}},{"name":"id","required":true,"in":"path","description":"A unique chargeback Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23c","type":"string"}}],"responses":{"200":{"description":"Returns Submit evidence status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceSubmissionStatusDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get the status of a evidence submission","tags":["Evidence"]}},"/files":{"post":{"description":"Upload a file to the Justt system. Use multipart/form-data with the file in a field named 'file'. Supported file types include documents, images, and other evidence files. For more details, visit https://developers.justt.ai/docs/file-upload-guide","operationId":"FilesController_create","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateFileDto"}}}},"responses":{"201":{"description":"File uploaded successfully - returns the new file ID and checksum","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Upload a file","tags":["Files"]}},"/data-subjects/removal":{"post":{"description":"Request to remove personal data from the Justt system in compliance with data protection regulations (GDPR, CCPA). This endpoint initiates the data deletion process for a specified customer.","operationId":"DataSubjectsController_requestDataSubjectRemoval","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Data subject removal request containing customer identifier","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSubjectRemovalRequestDto"}}}},"responses":{"201":{"description":"Data subject removal request processed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestApiResponseDTO"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Request data subject removal","tags":["Data Subjects"]}},"/merchants":{"get":{"description":"Retrieve a list of merchants with optional filtering and pagination","operationId":"MerchantsController_getMerchants","parameters":[{"name":"limit","required":false,"in":"query","description":"The number of items to return between 10 to 100","schema":{"default":10,"example":"10","type":"number"}},{"name":"page","required":false,"in":"query","description":"The offset of the first item to return","schema":{"default":1,"example":"1","type":"number"}}],"responses":{"200":{"description":"List of merchants retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMerchantsResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get merchants","tags":["Merchants"]},"delete":{"description":"Deactivate a merchant (note: merchant is not removed, only deactivated)","operationId":"MerchantsController_deactivateMerchant","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeactivateMerchantDto"}}}},"responses":{"200":{"description":"Merchant deactivated successfully"},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"Merchant not found","content":{"application/json":{"schema":{"example":{"message":"Merchant not found","statusCode":404}}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Deactivate merchant","tags":["Merchants"]},"post":{"description":"Create a new merchant with business profile information","operationId":"MerchantsController_createMerchant","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantDto"}}}},"responses":{"201":{"description":"Merchant created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Create merchant","tags":["Merchants"]}},"/merchants/{merchantUuid}":{"get":{"description":"Retrieve a single merchant by its UUID","operationId":"MerchantsController_getMerchant","parameters":[{"name":"merchantUuid","required":true,"in":"path","description":"A unique merchant Identifier (UUID) set by Justt","schema":{"example":"04318fb0-e4ff-4712-972e-4db99b3fb23d","type":"string"}}],"responses":{"200":{"description":"Merchant retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantResponseDto"}}}},"400":{"description":"Invalid merchant UUID format"},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get merchant by ID","tags":["Merchants"]}},"/integrations":{"get":{"description":"Retrieve a list of integrations with optional filtering and pagination","operationId":"IntegrationsController_getIntegrations","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"The number of items to return between 10 to 100","schema":{"default":10,"example":"10","type":"number"}},{"name":"page","required":false,"in":"query","description":"The offset of the first item to return","schema":{"default":1,"example":"1","type":"number"}}],"responses":{"200":{"description":"List of integrations retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IntegrationResponseDto"}}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get integrations","tags":["Integrations"]},"post":{"description":"Create a new payment integration","operationId":"IntegrationsController_createIntegration","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntegrationDto"}}}},"responses":{"201":{"description":"Integration created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntegrationResponseDto"}}}},"400":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Create integration","tags":["Integrations"]}},"/integrations/{id}":{"get":{"description":"Retrieve a single integration by its ID","operationId":"IntegrationsController_getIntegration","parameters":[{"name":"reference-account-id","in":"header","description":"If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Integration ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Integration retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationResponseDto"}}}},"400":{"description":"Invalid integration ID format"},"404":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}},"500":{"description":"In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDTO"}}}}},"security":[{"bearer":[]}],"summary":"Get integration by ID","tags":["Integrations"]},"delete":{"description":"Deactivate an integration (note: integration is not removed, only deactivated)","operationId":"IntegrationsController_deactivateIntegration","parameters":[{"name":"reference-account-id","in":"header","descript

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/justt/refs/heads/main/openapi/justt-rest-api-openapi-original.json