# Webhook Messages

The Webhook Messages API allows you to inspect and manage individual webhook delivery attempts. This is useful for debugging webhook issues.

{% hint style="warning" %}
You must include your **Bearer token** in the request header.
{% endhint %}

## Get Webhook Messages

> Retrieves a paginated list of webhook messages, optionally filtered by date range and status.

```json
{"openapi":"3.0.0","info":{"title":"GURUPAY API","version":"0.2.0"},"tags":[{"name":"WebhookMessages","description":"Viewing and managing webhook delivery messages/logs."}],"servers":[{"url":"https://public-api.gurupay.eu","description":"Production API Server"},{"url":"https://public-api-dev.gurupay.eu","description":"Sandbox API Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","description":"Authentication using a Bearer token.","name":"Authorization","in":"header","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"perPage":{"description":"Number of items to return per page in a paginated response.","type":"integer","default":15,"maximum":100,"minimum":1},"page":{"description":"The current page number for paginated results.","type":"integer","default":1,"minimum":1},"API.Resources.WebhookMessageResource":{"title":"Webhook Message Resource","description":"Resource representing the data structure of a webhook message.","properties":{"uuid":{"description":"Unique identifier for the webhook message.","type":"string","format":"uuid"},"created_at":{"description":"Timestamp when the webhook message was created.","type":"integer","format":"int64"},"status":{"description":"Delivery status of the webhook message.","type":"string","enum":["delivered","processing","error","retry"]},"account_uuid":{"description":"UUID of the account associated with the event that triggered the webhook.","type":"string","format":"uuid","nullable":true},"account":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.AccountSimpleResource"}],"nullable":true,"description":"Simplified details of the account associated with the event. Included based on webhook configuration."},"transaction":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.TransactionResource"}],"nullable":true,"description":"Details of the transaction associated with the event. Included for transaction-related webhooks."}},"type":"object"},"API.Resources.AccountSimpleResource":{"title":"Account Simple Resource","description":"Simplified resource representing key account details like UUID, number, currency, and balances.","required":["uuid","account_number","currency","balance","available_balance"],"properties":{"uuid":{"description":"Unique identifier for the account.","type":"string","format":"uuid"},"account_number":{"description":"The unique account number.","type":"string"},"currency":{"description":"The currency code of the account","type":"string","enum":["EUR","GBP","USD"]},"balance":{"description":"The current ledger balance of the account.","type":"number","format":"float"},"balance_national":{"description":"The current ledger balance of the account in the national currency.","type":"number","format":"float"},"book_balance":{"description":"The available book balance of the account. **Not used**","type":"number","format":"float"},"book_balance_national":{"description":"The available book balance of the account in the national currency. **Not used**","type":"number","format":"float"},"available_balance":{"description":"The current available balance of the account.","type":"number","format":"float"},"available_balance_national":{"description":"The current available balance of the account in the national currency.","type":"number","format":"float"},"hold":{"description":"The total amount of funds currently on hold in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount":{"description":"The total amount reserved for card transactions in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount_national":{"description":"The total amount reserved for card transactions in the national currency. **Not used**","type":"number","format":"float"}},"type":"object"},"API.Resources.TransactionResource":{"title":"Transaction Resource","description":"Detailed information about a financial transaction.","properties":{"uuid":{"description":"Unique identifier for the transaction.","type":"string","format":"uuid"},"parent_transaction_uuid":{"description":"UUID of the parent transaction.","type":"string","format":"uuid","nullable":true},"status":{"description":"Current processing status of the transaction.","type":"string","enum":["created","pending","processed","canceled","rejected"]},"aml_status":{"description":"**DEPRECATED:** This field is scheduled for removal on August 4th, 2025. It is already deprecated in the Sandbox environment. Anti-Money Laundering (AML) check status of the transaction.","type":"string","enum":["rejected","approved","error","canceled","pending"],"deprecated":true},"operation_date":{"description":"Date of the transaction operation (YYYY-MM-DD).","type":"string","format":"date"},"operation_date_time":{"description":"Date and time of the transaction operation (ISO 8601 format).","type":"string","format":"date-time"},"operation_date_unix":{"description":"Date and time of the transaction operation as a Unix timestamp (seconds since epoch).","type":"integer","format":"int64"},"amount":{"description":"Transaction amount.","type":"number","format":"float"},"currency":{"description":"Currency code (ISO 4217).","type":"string","format":"ISO 4217"},"payment_type":{"description":"Type of payment rails used.","type":"string","enum":["SEPA","SWIFT","FX","INTERNAL"]},"transaction_type":{"description":"Type of financial transaction, such as payment, return, adjustment, or fee.","type":"string","enum":["payment","return","adjustment","fee"]},"payment_urgency":{"description":"Urgency level of the payment.","type":"string","enum":["NORMAL","URGENT"],"nullable":true},"payment_details":{"description":"Remittance information or payment details provided by the payer.","type":"string","nullable":true},"payment_code":{"description":"Optional payment code associated with the transaction.","type":"string","nullable":true},"end_to_end_ident":{"description":"End-to-end identifier for tracking the payment across systems.","type":"string","nullable":true},"direction":{"description":"Direction of the transaction relative to the account holder.","type":"string","enum":["CREDIT","DEBIT"]},"document_number":{"description":"Reference number of an associated document, if any.","type":"string","nullable":true},"created_at":{"description":"Timestamp when the transaction record was created in the system (Unix timestamp).","type":"integer","format":"int64"},"payer":{"description":"Details of the transaction payer.","required":["name","iban"],"properties":{"name":{"description":"Payer's full name.","type":"string"},"iban":{"description":"Payer's International Bank Account Number.","type":"string"},"address":{"description":"Payer's address.","type":"string","nullable":true},"country_code":{"description":"Payer's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the payer's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the payer's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the payer's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate debtor, if different from the payer.","properties":{"name":{"description":"Ultimate debtor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"recipient":{"description":"Details of the transaction recipient.","required":["name","iban"],"properties":{"name":{"description":"Recipient's full name.","type":"string"},"iban":{"description":"Recipient's International Bank Account Number.","type":"string"},"address":{"description":"Recipient's address.","type":"string","nullable":true},"country_code":{"description":"Recipient's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the recipient's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the recipient's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the recipient's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate creditor, if different from the recipient.","properties":{"name":{"description":"Ultimate creditor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"verification_of_payee":{"description":"Verification of the payee match status.","type":"string","enum":["MATCH","CLOSE_MATCH","NO_MATCH","CANNOT_VERIFY"]}},"type":"object"},"UnauthenticatedResponse":{"properties":{"status":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}}},"type":"object"}}},"paths":{"/api/v1/webhooks_messages":{"get":{"tags":["WebhookMessages"],"summary":"Get Webhook Messages","description":"Retrieves a paginated list of webhook messages, optionally filtered by date range and status.","operationId":"API.WebhooksMessages.Get","parameters":[{"name":"date_from","in":"query","description":"Filter messages created from this date (YYYY-MM-DD).","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"date_to","in":"query","description":"Filter messages created up to this date (YYYY-MM-DD).","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"per_page","in":"query","description":"Number of messages to return per page.","required":false,"schema":{"$ref":"#/components/schemas/perPage"}},{"name":"page","in":"query","description":"The page number to retrieve.","required":false,"schema":{"$ref":"#/components/schemas/page"}},{"name":"direction","in":"query","description":"Sort direction for the message list.","required":false,"schema":{"type":"string","default":"desc","enum":["asc","desc"]}},{"name":"sort","in":"query","description":"Field to sort the message list by.","required":false,"schema":{"type":"string","default":"created_at","enum":["created_at"]}},{"name":"status","in":"query","description":"Filter messages by their delivery status.","required":false,"schema":{"type":"string","enum":["processing","delivered","error","retry"]}}],"responses":{"200":{"description":"A paginated list of webhook messages.","headers":{"X-Api-Total":{"description":"Total number of webhook messages matching the filter criteria.","schema":{"type":"integer"}},"X-Api-Per-Page":{"description":"Number of messages returned on the current page.","schema":{"type":"integer"}},"X-Api-Current-Page":{"description":"The current page number being returned.","schema":{"type":"integer"}},"X-Api-Has-More-Pages":{"description":"Indicates if there are more pages available.","schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/API.Resources.WebhookMessageResource"}}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}}}}
```

## Get Webhook message by UUID

> Retrieves the details of a specific webhook message by its UUID.

```json
{"openapi":"3.0.0","info":{"title":"GURUPAY API","version":"0.2.0"},"tags":[{"name":"WebhookMessages","description":"Viewing and managing webhook delivery messages/logs."}],"servers":[{"url":"https://public-api.gurupay.eu","description":"Production API Server"},{"url":"https://public-api-dev.gurupay.eu","description":"Sandbox API Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","description":"Authentication using a Bearer token.","name":"Authorization","in":"header","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"UUID":{"description":"Universally Unique Identifier (UUID) as defined by RFC 4122.","type":"string","format":"uuid","pattern":"^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$"},"API.Resources.WebhookMessageResource":{"title":"Webhook Message Resource","description":"Resource representing the data structure of a webhook message.","properties":{"uuid":{"description":"Unique identifier for the webhook message.","type":"string","format":"uuid"},"created_at":{"description":"Timestamp when the webhook message was created.","type":"integer","format":"int64"},"status":{"description":"Delivery status of the webhook message.","type":"string","enum":["delivered","processing","error","retry"]},"account_uuid":{"description":"UUID of the account associated with the event that triggered the webhook.","type":"string","format":"uuid","nullable":true},"account":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.AccountSimpleResource"}],"nullable":true,"description":"Simplified details of the account associated with the event. Included based on webhook configuration."},"transaction":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.TransactionResource"}],"nullable":true,"description":"Details of the transaction associated with the event. Included for transaction-related webhooks."}},"type":"object"},"API.Resources.AccountSimpleResource":{"title":"Account Simple Resource","description":"Simplified resource representing key account details like UUID, number, currency, and balances.","required":["uuid","account_number","currency","balance","available_balance"],"properties":{"uuid":{"description":"Unique identifier for the account.","type":"string","format":"uuid"},"account_number":{"description":"The unique account number.","type":"string"},"currency":{"description":"The currency code of the account","type":"string","enum":["EUR","GBP","USD"]},"balance":{"description":"The current ledger balance of the account.","type":"number","format":"float"},"balance_national":{"description":"The current ledger balance of the account in the national currency.","type":"number","format":"float"},"book_balance":{"description":"The available book balance of the account. **Not used**","type":"number","format":"float"},"book_balance_national":{"description":"The available book balance of the account in the national currency. **Not used**","type":"number","format":"float"},"available_balance":{"description":"The current available balance of the account.","type":"number","format":"float"},"available_balance_national":{"description":"The current available balance of the account in the national currency.","type":"number","format":"float"},"hold":{"description":"The total amount of funds currently on hold in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount":{"description":"The total amount reserved for card transactions in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount_national":{"description":"The total amount reserved for card transactions in the national currency. **Not used**","type":"number","format":"float"}},"type":"object"},"API.Resources.TransactionResource":{"title":"Transaction Resource","description":"Detailed information about a financial transaction.","properties":{"uuid":{"description":"Unique identifier for the transaction.","type":"string","format":"uuid"},"parent_transaction_uuid":{"description":"UUID of the parent transaction.","type":"string","format":"uuid","nullable":true},"status":{"description":"Current processing status of the transaction.","type":"string","enum":["created","pending","processed","canceled","rejected"]},"aml_status":{"description":"**DEPRECATED:** This field is scheduled for removal on August 4th, 2025. It is already deprecated in the Sandbox environment. Anti-Money Laundering (AML) check status of the transaction.","type":"string","enum":["rejected","approved","error","canceled","pending"],"deprecated":true},"operation_date":{"description":"Date of the transaction operation (YYYY-MM-DD).","type":"string","format":"date"},"operation_date_time":{"description":"Date and time of the transaction operation (ISO 8601 format).","type":"string","format":"date-time"},"operation_date_unix":{"description":"Date and time of the transaction operation as a Unix timestamp (seconds since epoch).","type":"integer","format":"int64"},"amount":{"description":"Transaction amount.","type":"number","format":"float"},"currency":{"description":"Currency code (ISO 4217).","type":"string","format":"ISO 4217"},"payment_type":{"description":"Type of payment rails used.","type":"string","enum":["SEPA","SWIFT","FX","INTERNAL"]},"transaction_type":{"description":"Type of financial transaction, such as payment, return, adjustment, or fee.","type":"string","enum":["payment","return","adjustment","fee"]},"payment_urgency":{"description":"Urgency level of the payment.","type":"string","enum":["NORMAL","URGENT"],"nullable":true},"payment_details":{"description":"Remittance information or payment details provided by the payer.","type":"string","nullable":true},"payment_code":{"description":"Optional payment code associated with the transaction.","type":"string","nullable":true},"end_to_end_ident":{"description":"End-to-end identifier for tracking the payment across systems.","type":"string","nullable":true},"direction":{"description":"Direction of the transaction relative to the account holder.","type":"string","enum":["CREDIT","DEBIT"]},"document_number":{"description":"Reference number of an associated document, if any.","type":"string","nullable":true},"created_at":{"description":"Timestamp when the transaction record was created in the system (Unix timestamp).","type":"integer","format":"int64"},"payer":{"description":"Details of the transaction payer.","required":["name","iban"],"properties":{"name":{"description":"Payer's full name.","type":"string"},"iban":{"description":"Payer's International Bank Account Number.","type":"string"},"address":{"description":"Payer's address.","type":"string","nullable":true},"country_code":{"description":"Payer's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the payer's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the payer's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the payer's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate debtor, if different from the payer.","properties":{"name":{"description":"Ultimate debtor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"recipient":{"description":"Details of the transaction recipient.","required":["name","iban"],"properties":{"name":{"description":"Recipient's full name.","type":"string"},"iban":{"description":"Recipient's International Bank Account Number.","type":"string"},"address":{"description":"Recipient's address.","type":"string","nullable":true},"country_code":{"description":"Recipient's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the recipient's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the recipient's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the recipient's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate creditor, if different from the recipient.","properties":{"name":{"description":"Ultimate creditor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"verification_of_payee":{"description":"Verification of the payee match status.","type":"string","enum":["MATCH","CLOSE_MATCH","NO_MATCH","CANNOT_VERIFY"]}},"type":"object"},"UnauthenticatedResponse":{"properties":{"status":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}}},"type":"object"},"ValidationResponse":{"title":"Validation Error Response","description":"Standard response format for validation errors (HTTP 422).","required":["status","status_code","message","errors"],"properties":{"status":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"errors":{"description":"An object containing validation errors. Keys are field names, values are arrays of error messages for that field.","type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"type":"object"}}},"paths":{"/api/v1/webhooks_messages/{uuid}":{"get":{"tags":["WebhookMessages"],"summary":"Get Webhook message by UUID","description":"Retrieves the details of a specific webhook message by its UUID.","operationId":"API.WebhooksMessages.Show","parameters":[{"name":"uuid","in":"path","description":"The UUID of the Webhook Message to retrieve.","required":true,"schema":{"$ref":"#/components/schemas/UUID"}}],"responses":{"200":{"description":"Successfully retrieved the webhook message details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/API.Resources.WebhookMessageResource"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"422":{"description":"Unprocessable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResponse"}}}}}}}}}
```

## Update webhook message status

> Allows updating the status of a specific webhook message.

```json
{"openapi":"3.0.0","info":{"title":"GURUPAY API","version":"0.2.0"},"tags":[{"name":"WebhookMessages","description":"Viewing and managing webhook delivery messages/logs."}],"servers":[{"url":"https://public-api.gurupay.eu","description":"Production API Server"},{"url":"https://public-api-dev.gurupay.eu","description":"Sandbox API Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","description":"Authentication using a Bearer token.","name":"Authorization","in":"header","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"UUID":{"description":"Universally Unique Identifier (UUID) as defined by RFC 4122.","type":"string","format":"uuid","pattern":"^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$"},"API.Resources.WebhookMessageResource":{"title":"Webhook Message Resource","description":"Resource representing the data structure of a webhook message.","properties":{"uuid":{"description":"Unique identifier for the webhook message.","type":"string","format":"uuid"},"created_at":{"description":"Timestamp when the webhook message was created.","type":"integer","format":"int64"},"status":{"description":"Delivery status of the webhook message.","type":"string","enum":["delivered","processing","error","retry"]},"account_uuid":{"description":"UUID of the account associated with the event that triggered the webhook.","type":"string","format":"uuid","nullable":true},"account":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.AccountSimpleResource"}],"nullable":true,"description":"Simplified details of the account associated with the event. Included based on webhook configuration."},"transaction":{"oneOf":[{"$ref":"#/components/schemas/API.Resources.TransactionResource"}],"nullable":true,"description":"Details of the transaction associated with the event. Included for transaction-related webhooks."}},"type":"object"},"API.Resources.AccountSimpleResource":{"title":"Account Simple Resource","description":"Simplified resource representing key account details like UUID, number, currency, and balances.","required":["uuid","account_number","currency","balance","available_balance"],"properties":{"uuid":{"description":"Unique identifier for the account.","type":"string","format":"uuid"},"account_number":{"description":"The unique account number.","type":"string"},"currency":{"description":"The currency code of the account","type":"string","enum":["EUR","GBP","USD"]},"balance":{"description":"The current ledger balance of the account.","type":"number","format":"float"},"balance_national":{"description":"The current ledger balance of the account in the national currency.","type":"number","format":"float"},"book_balance":{"description":"The available book balance of the account. **Not used**","type":"number","format":"float"},"book_balance_national":{"description":"The available book balance of the account in the national currency. **Not used**","type":"number","format":"float"},"available_balance":{"description":"The current available balance of the account.","type":"number","format":"float"},"available_balance_national":{"description":"The current available balance of the account in the national currency.","type":"number","format":"float"},"hold":{"description":"The total amount of funds currently on hold in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount":{"description":"The total amount reserved for card transactions in the account's currency. **Not used**","type":"number","format":"float"},"cards_reserved_amount_national":{"description":"The total amount reserved for card transactions in the national currency. **Not used**","type":"number","format":"float"}},"type":"object"},"API.Resources.TransactionResource":{"title":"Transaction Resource","description":"Detailed information about a financial transaction.","properties":{"uuid":{"description":"Unique identifier for the transaction.","type":"string","format":"uuid"},"parent_transaction_uuid":{"description":"UUID of the parent transaction.","type":"string","format":"uuid","nullable":true},"status":{"description":"Current processing status of the transaction.","type":"string","enum":["created","pending","processed","canceled","rejected"]},"aml_status":{"description":"**DEPRECATED:** This field is scheduled for removal on August 4th, 2025. It is already deprecated in the Sandbox environment. Anti-Money Laundering (AML) check status of the transaction.","type":"string","enum":["rejected","approved","error","canceled","pending"],"deprecated":true},"operation_date":{"description":"Date of the transaction operation (YYYY-MM-DD).","type":"string","format":"date"},"operation_date_time":{"description":"Date and time of the transaction operation (ISO 8601 format).","type":"string","format":"date-time"},"operation_date_unix":{"description":"Date and time of the transaction operation as a Unix timestamp (seconds since epoch).","type":"integer","format":"int64"},"amount":{"description":"Transaction amount.","type":"number","format":"float"},"currency":{"description":"Currency code (ISO 4217).","type":"string","format":"ISO 4217"},"payment_type":{"description":"Type of payment rails used.","type":"string","enum":["SEPA","SWIFT","FX","INTERNAL"]},"transaction_type":{"description":"Type of financial transaction, such as payment, return, adjustment, or fee.","type":"string","enum":["payment","return","adjustment","fee"]},"payment_urgency":{"description":"Urgency level of the payment.","type":"string","enum":["NORMAL","URGENT"],"nullable":true},"payment_details":{"description":"Remittance information or payment details provided by the payer.","type":"string","nullable":true},"payment_code":{"description":"Optional payment code associated with the transaction.","type":"string","nullable":true},"end_to_end_ident":{"description":"End-to-end identifier for tracking the payment across systems.","type":"string","nullable":true},"direction":{"description":"Direction of the transaction relative to the account holder.","type":"string","enum":["CREDIT","DEBIT"]},"document_number":{"description":"Reference number of an associated document, if any.","type":"string","nullable":true},"created_at":{"description":"Timestamp when the transaction record was created in the system (Unix timestamp).","type":"integer","format":"int64"},"payer":{"description":"Details of the transaction payer.","required":["name","iban"],"properties":{"name":{"description":"Payer's full name.","type":"string"},"iban":{"description":"Payer's International Bank Account Number.","type":"string"},"address":{"description":"Payer's address.","type":"string","nullable":true},"country_code":{"description":"Payer's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the payer's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the payer's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the payer's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate debtor, if different from the payer.","properties":{"name":{"description":"Ultimate debtor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"recipient":{"description":"Details of the transaction recipient.","required":["name","iban"],"properties":{"name":{"description":"Recipient's full name.","type":"string"},"iban":{"description":"Recipient's International Bank Account Number.","type":"string"},"address":{"description":"Recipient's address.","type":"string","nullable":true},"country_code":{"description":"Recipient's country code (ISO 3166-1 alpha-2).","type":"string","format":"ISO 3166-1 alpha-2","nullable":true},"agency_id":{"description":"Identifier of the recipient's bank/agent (e.g., BIC/SWIFT code).","type":"string","nullable":true},"agency_name":{"description":"Name of the recipient's bank/agent.","type":"string","nullable":true},"agency_address":{"description":"Address of the recipient's bank/agent.","type":"string","nullable":true},"ultimate":{"description":"Details of the ultimate creditor, if different from the recipient.","properties":{"name":{"description":"Ultimate creditor's name.","type":"string"}},"type":"object","nullable":true}},"type":"object"},"verification_of_payee":{"description":"Verification of the payee match status.","type":"string","enum":["MATCH","CLOSE_MATCH","NO_MATCH","CANNOT_VERIFY"]}},"type":"object"},"UnauthenticatedResponse":{"properties":{"status":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}}},"type":"object"},"ValidationResponse":{"title":"Validation Error Response","description":"Standard response format for validation errors (HTTP 422).","required":["status","status_code","message","errors"],"properties":{"status":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"errors":{"description":"An object containing validation errors. Keys are field names, values are arrays of error messages for that field.","type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"type":"object"}}},"paths":{"/api/v1/webhooks_messages/{uuid}":{"patch":{"tags":["WebhookMessages"],"summary":"Update webhook message status","description":"Allows updating the status of a specific webhook message.","operationId":"API.WebhooksMessages.Update","parameters":[{"name":"uuid","in":"path","description":"The UUID of the Webhook Message to update.","required":true,"schema":{"$ref":"#/components/schemas/UUID"}},{"name":"status","in":"query","description":"The new status to set for the webhook message.","required":true,"schema":{"type":"string","enum":["processing","delivered","error","retry"]}}],"responses":{"200":{"description":"Webhook message status updated successfully. Returns the updated resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/API.Resources.WebhookMessageResource"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"422":{"description":"Unprocessable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResponse"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.gurupay.eu/api-reference/webhook-messages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.